erosolar-cli/README.md

Unified AI agent framework for the command line - Multi-provider support with schema-driven tools, code intelligence, and transparent reasoning

# erosolar-cli

Unified command-line agent with a single, persistent chat box pinned to the bottom of every session. Output streams scroll above it while the prompt and status controls stay anchored.

## Highlights
- One chat box, always on the bottom during the entire session (idle or streaming).
- Shared control bar for status, verify/build toggle, auto-continue, and context gauge.
- Works with OpenAI, Anthropic, Google, xAI, DeepSeek, and local Ollama using the same UI contract.
- Multi-agent Task tool with built-in general-purpose, explore (read-only), and plan subagents; add custom agents from `.claude/agents`, `~/.claude/agents`, or `--agents` JSON.

## Install
```bash
npm install -g erosolar-cli
# or
npx erosolar-cli
```

## Run
```bash
# default profile
erosolar

# choose model/provider
erosolar --provider openai --model gpt-4o

# restore last session
erosolar --restore
```

## Configure
Set the keys you need before launching:
```bash
OPENAI_API_KEY=...
ANTHROPIC_API_KEY=...
GOOGLE_API_KEY=...
XAI_API_KEY=...
DEEPSEEK_API_KEY=...
OLLAMA_BASE_URL=http://localhost:11434
```

## Options
- `--provider <name>` pick the AI provider
- `--model <name>` choose a model
- `--profile <name>` switch agent profiles (e.g., `erosolar-code`)
- `--restore` resume the previous session
- `--version` show the CLI version
- `--agents '<json>'` register inline subagent definitions (name keyed object with description/prompt/tools/model)

MIT licensed.