@gthos/cli
v0.11.0
Published
GroundTruth OS CLI — connect your AI agents to a canonical knowledge base
Maintainers
Readme
@gthos/cli
Connect your AI agents to a GroundTruth OS canonical knowledge base.
Quick Start
npx @gthos/cli initThis detects your coding agents (Claude Code, Cursor, VS Code Copilot, Windsurf) and configures them to use your GroundTruth OS workspace as their source of truth.
What gthos init does
- Detects which AI coding platforms are in your project
- Writes MCP server config for each detected platform
- Creates an
AGENTS.mdwith your canonical doc inventory and agent instructions - Appends a GroundTruth OS reference to
CLAUDE.md(if present) - Installs Claude Code skills for reading/updating your knowledge base
- Verifies the MCP connection works
Authentication
gthos auth login # Browser-based login
gthos init --key <key> # Or pass an API key directlyCommands
| Command | Description |
|---------|-------------|
| gthos init | Set up GroundTruth OS for your project |
| gthos auth login | Authenticate via browser |
| gthos auth status | Show current auth state |
| gthos docs list | List canonical documents |
| gthos docs get <type> | Read a canonical document |
| gthos docs update <type> | Update a canonical document |
| gthos export prompt | Compile canonical docs into a system prompt |
| gthos changes | See recent changes by others |
| gthos decide <title> | Record an architectural decision |
| gthos workspace | Show current workspace info |
Environment Variables
| Variable | Description |
|----------|-------------|
| GTHOS_API_KEY | API key for authentication (alternative to gthos auth login) |
| GTHOS_BASE_URL | Server URL (default: https://groundtruthos.ai) |
