gnosis-cli 1.0.0
Terminal interface for Gnosis - Multi-agent coordination, LLM routing, and memory systems
Requires Python: >=3.10
Keywords: anthropic, claude, cli, coordination, llm, multi-agent, terminal

# Gnosis CLI

Terminal interface for Gnosis - Multi-agent coordination, LLM routing, and memory systems.

## Installation

```bash
# Basic installation
pip install gnosis-cli

# With all features (embeddings, LLM routing)
pip install gnosis-cli[full]

# Or install from source
cd mcp-server
pip install -e .
```

## Quick Start

```bash
# First-time setup
gnosis init

# Show system status
gnosis status

# Natural language task execution
gnosis do "claim the auth service"
gnosis do "who's working on what"
```

## Commands

### Core Commands

| Command | Description |
|---------|-------------|
| `gnosis` | Show status overview (default) |
| `gnosis init` | First-run setup wizard |
| `gnosis status` | System status overview |
| `gnosis version` | Version and system info |
| `gnosis doctor` | Run system diagnostics |
| `gnosis do "<intent>"` | Natural language task execution |

### Session Management

```bash
gnosis session list              # List active sessions
gnosis session close <id>        # Close a session
gnosis session recover           # Recover stale sessions
```

### File & Branch Coordination

```bash
gnosis file claim <path>         # Claim a file for editing
gnosis file release <path>       # Release a file claim
gnosis file list                 # List all file claims

gnosis branch claim <name>       # Claim a branch
gnosis branch release <name>     # Release a branch
gnosis branch list               # List branch claims
```

### LLM Router

Switch between LLM providers seamlessly:

```bash
gnosis router status             # Show current configuration
gnosis router use claude         # Switch to Claude (Anthropic)
gnosis router use groq           # Switch to Groq (fast, cheap)
gnosis router use openai         # Switch to OpenAI
gnosis router providers          # List all providers
```

### Configuration

```bash
gnosis config list               # Show all settings
gnosis config get <key>          # Get a config value
gnosis config set <key> <value>  # Set a config value
gnosis config edit               # Open in $EDITOR
```

### Memory & Learning

```bash
gnosis memory query "OAuth"      # Search MAGMA memory
gnosis lessons show              # Show recent lessons
gnosis lessons search "auth"     # Search lessons
```

### Utilities

```bash
gnosis backup create             # Create backup
gnosis backup restore <file>     # Restore from backup
gnosis worktree create <branch>  # Create git worktree
gnosis completion zsh            # Generate shell completions
```

## Shell Completions

```bash
# Zsh
gnosis completion zsh > ~/.gnosis/completions/_gnosis
echo 'fpath=(~/.gnosis/completions $fpath)' >> ~/.zshrc

# Bash
gnosis completion bash > ~/.gnosis/completions/gnosis.bash
echo 'source ~/.gnosis/completions/gnosis.bash' >> ~/.bashrc

# Fish
gnosis completion fish > ~/.config/fish/completions/gnosis.fish
```

## Configuration

Configuration is stored in `~/.gnosis/config.toml`:

```toml
[user]
name = "Your Name"
role = "developer"

[providers]
default = "anthropic"
model = "claude-sonnet-4-20250514"

[coordination]
enabled = true
auto_register = true

[shell]
completions = "zsh"
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `ANTHROPIC_API_KEY` | Claude API key |
| `OPENAI_API_KEY` | OpenAI API key |
| `GROQ_API_KEY` | Groq API key |
| `GOOGLE_API_KEY` | Google AI API key |
| `GNOSIS_SESSION_ID` | Current session ID |

## JSON Output

All commands support `--json` flag for machine-readable output:

```bash
gnosis status --json
gnosis session list --json
gnosis router status --json
```

## License

MIT