contents · Commands
Commands
All of GLAD’s commands.
Flags most commands take
| --service <url> | Team service URL. Omit for the local service. |
| --graph-dir <dir> | Graph folder. Default ~/. |
| --json | JSON output. decisions, doctor. |
<repo-path> is a checkout on this machine, and <repository> a checkout or its origin URL. In brackets, either defaults to the folder you’re in.
On your machine
glad login
Authenticates via GitHub device flow or an admin-issued key; stores this machine’s signing credential. Locally, also starts the service.
| --key <key> | Use a key from glad admin key. |
glad logout
Deletes and revokes this machine’s credential. Records stay.
glad arm
Writes hooks, MCP server and skill into your own harness settings; starts the service if needed. Once per repository: every clone and worktree of it runs GLAD, and no other folder does.
| --harness | claude-code (default) or codex. Both may be armed. |
glad disarm
Turns GLAD off for every folder of the repository, and removes what arm wrote once no repository is left armed. An arm-started service stops with it.
glad open
Opens your decision graph in the browser, signed in as you. Remote team services: https only.
| --no-browser | Print a one-use link, valid 1 minute. |
glad decisions
Decisions in force: who, which prompt, branch status, code, what it replaced, open contradictions.
glad flags
Undecided changes, newest first.
Closes a flag that sets no rule, recorded as you with the time. Writes no decision.
glad doctor
Checks your whole setup and fixes what it can on the spot. Run it whenever something seems off.
- One line per check: ✓ passed, ✗ failed with the cause and the fix.
- Its repairs never lose data, can always be undone, and touch only your setup.
- Exits 1 while a problem remains.
- Given an origin URL with no local checkout, checks the machine that runs the team’s service, or with
--service <url>that service from any other machine.
Running a team’s shared GLAD
glad serve
Runs a shared service in the foreground. No checkout needed: pass the origin URL.
Team deployments are single-tenant, in your private cloud or on-premise. Book a demo.
| --port <n> | Default 7737. |
| --listen <addr> | Default localhost. Wider: no logins until a team exists. |
| --tls-cert, --tls-key | PEM files. Serve https (required for remote graph pages). |
$ glad serve git@github.com:example/pay.git --listen 0.0.0.0 \
--tls-cert cert.pem --tls-key key.pemglad admin
All take --service and --graph-dir. <who>: GitHub login or key id.
| team create [<repository>] <team name> <who> | Make the team and name its first admin. Run it on the box. |
| team add [<repository>] <who> | Add someone to the team. |
| team remove [<repository>] <who> | Remove someone from the team. Remove their admin role first. |
| team register [<repository>] --token <token> [--ip <address>] | Link the box to its team at glad--service https:/. |
| role grant [<repository>] <who> admin | Make someone an admin. |
| role revoke [<repository>] <who> admin | Remove someone’s admin role. A team always keeps at least one admin. |
| key [<repository>] --for <name> <email> | Issue a login key for someone without GitHub, and add them to the team. Shown once. |
| revoke [<repository>] <credential id> | Revoke a credential or a key. |
| release-branches [<repository>] <pattern>… | --clear | Branches that count as releases, beside tags. |
| graph connect [<repository>] | Serve this repository’s graph on this box. |
| graph delete [<repository>] | Move its graph aside under a dated name. Nothing is removed. |
$ glad admin team add <github login>
glad slack
Connects GLAD to your team’s Slack. connect, channel, disconnect and link <who> are for admins; link alone and status are for anyone on the team.
| connect [<repository>] [--no-browser] | Add GLAD to your Slack workspace. Slack asks for the channel. |
| connect [<repository>] --token-file <file> --channel <channel> | Connect your own Slack app instead, for on-premise. |
| channel [<repository>] <channel> | Move GLAD’s posts to another channel (#name or an id). |
| link [<repository>] [--no-browser] | Link your own Slack account by signing in to Slack. |
| link [<repository>] <who> <member id> | Link someone by hand. |
| status [<repository>] | The workspace, the channel, and who is linked. |
| disconnect [<repository>] | Stop posting to Slack. |
glad linear
Connects GLAD to your team’s Linear. For admins, except status.
| connect [<repository>] [--no-browser] | Add GLAD to your Linear workspace. |
| connect [<repository>] --key-file <file> | Connect with a Linear API key instead, for on-premise. |
| status [<repository>] | The workspace GLAD posts to. |
| disconnect [<repository>] | Stop posting to Linear. |
Misha off unless your team turns it on
The Minimum Invasiveness Supervisor Harness for Agents: when a decision changes, Misha updates the code that depends on it. Opt-in, per team.
| glad admin misha [<repository>] on|off | The team’s switch. |
| glad admin misha [<repository>] never <thing> [--remove] | Add a thing Misha must never change alone, or remove one. |
| glad misha enroll [<repo-path>] [--service <url>] [--graph-dir <dir>] | Run Misha’s worker on this laptop (macOS, Linux or Windows), about once a minute while it is awake. |
| glad misha disenroll [<repo-path>] [--graph-dir <dir>] | Remove it. |
| glad build-ripple [<repo-path>] <ripple-id> [--service <url>] [--graph-dir <dir>] | Run one claimed job by hand, as the worker would. |
| glad ripple undo <ripple-id> [--service <url>] [--graph-dir <dir>] | Take a ripple back: close its pull request before it merges, or open a revert after. |
Help and version
| glad --help | Every command, with what it does. |
| glad --version | The installed version. |
| glad update | Install the newest version. |
Internal, not for manual use: mcp, hook, close-turn and similar.