dx-hub-config

You view and edit the hub configuration in .ai/config.yaml.

Pre-flight

Read .ai/config.yaml. If a hub: section is absent, STOP:

Hub mode is not configured. Run /dx-hub-init first.

1. Parse Subcommand

Inspect $ARGUMENTS and route to the matching section:

Subcommand	Action
(none) or show	Display current hub config
add-repo <path>	Discover and add a repo
terminal-delay <seconds>	Set seconds to wait for Claude to start in terminal

2. show

Print hub settings in readable format:

Hub Configuration
─────────────────────────────────
Enabled:         <hub.enabled>
Terminal delay:  <hub.terminal-delay>s
State TTL:       <hub.state-ttl>

Repos (<count>):
  - <name>  <path>  [capabilities: <caps>]  [base: <base-branch>]  [project: <project>]
  ...

3. add-repo

1. Resolve the path (expand ~, make absolute).
2. Check that <path>/.ai/config.yaml exists. If not, STOP: "No .ai/config.yaml found at <path>. Is this a dx-enabled project?"
3. Read <path>/.ai/config.yaml and extract:
   • name (or derive from directory name)
   • scm.base-branch (default main if absent)
   • scm.project (optional)
4. Check for a duplicate: if hub.repos already contains an entry with the same name, STOP: "Repo <name> is already in the hub. Use show to review current repos."
5. Append to hub.repos in .ai/config.yaml:

   - name: <name>
     path: <resolved-path>
     base-branch: <base-branch>
     project: <project>       # omit if absent
   

6. Print confirmation:

   Added <name> (<resolved-path>) to hub. Total repos: .

4. terminal-delay

1. Validate <seconds> is a positive integer between 1 and 30. If not, STOP: "Invalid delay <seconds>. Use a number between 1 and 30."
2. Update hub.terminal-delay in .ai/config.yaml.
3. Print: > Terminal delay set to <seconds>s.

Examples

/dx-hub-config
/dx-hub-config show

Prints current hub settings and all registered repos.

/dx-hub-config add-repo ../my-other-repo

Reads ../my-other-repo/.ai/config.yaml, extracts metadata, and adds the repo to the hub.

/dx-hub-config terminal-delay 8

Updates the terminal startup delay and confirms the change.

Troubleshooting

"Hub mode is not configured"

Cause: .ai/config.yaml has no hub: section. Fix: Run /dx-hub-init to initialise hub mode first.

"No .ai/config.yaml found at <path>"

Cause: The target directory is not a dx-enabled project, or the path is wrong. Fix: Run /dx-init in the target repo, then retry.

"Repo <name> is already in the hub"

Cause: A repo with that name is already registered. Fix: Run /dx-hub-config show to review existing entries.