citadel-cli is the terminal interface for Citadel: namespaces, repos, agents, OAuth, audit, and the knowledge graph. Operators administer the platform; developers clone, push, and script against the API without leaving the shell.
The CLI embeds an MCP client and structured error envelopes for agentic workflows — same commands humans use, with machine-readable output modes.
go install github.com/Rethunk-Tech/citadel-cli@latestInstall, auth, and local development: HUMANS.md.
- Repo and namespace lifecycle — clone, push, issues, deploy tokens, webhooks, org members
- Agents, OAuth, and tokens — registration, scopes, provider admin
- Knowledge Graph — traverse the Citadel project graph and repo insights
- Audit logs — search and stream events and session logs
- Embedded MCP client — first-class agentic and LLM workflow integration
- Scriptable output — json, yaml, ndjson, csv, table, and shell completion
| Document | Description |
|---|---|
| docs/cli.md | Full command reference |
| HUMANS.md | Maintainer primer — install, auth, output formats, shell completion |
| AGENTS.md | Agent and LLM working conventions |
| CONTRIBUTING.md | Commits, branches, pre-push checklist |
| CHANGELOG.md | Release notes |