eigent/cli/README.md
2026-03-09 20:51:51 -07:00

99 lines
2 KiB
Markdown

# Eigent CLI
Command-line interface for the Eigent AI coding agent.
## Prerequisites
- Node.js >= 18
- Eigent backend running (default: `http://localhost:5001`)
## Installation
```bash
# From the repo root
cd cli
npm install
npm run build
npm install -g .
```
After installation, the `eigent` command is available globally.
## Configuration
Run the config wizard to set your API key, model, and backend URL:
```bash
eigent config
```
Config is stored at `~/.eigent/cli-config.json`.
You can also use environment variables (or `.env.development` at the repo root):
```
EIGENT_API_URL=http://localhost:5001
EIGENT_API_KEY=sk-...
EIGENT_MODEL_PLATFORM=openai
EIGENT_MODEL_TYPE=gpt-4o
EIGENT_EMAIL=you@example.com
```
## Usage
### Interactive mode (REPL)
```bash
eigent
```
### One-shot mode
```bash
eigent "search for YC W2026 companies and save one to w26.json"
```
### CLI options
```
eigent [question] Ask a question (one-shot mode)
eigent config Configure API key, model, backend URL
eigent --help Show help
eigent --version Show version
```
### REPL commands
| Command | Description |
|----------------------|--------------------------------------|
| `/new` | Start a new conversation |
| `/project` | Show current project ID |
| `/workspace` | Show current workspace path |
| `/workspace <path>` | Change workspace directory |
| `/stop` | Stop the current task |
| `/quit` or `/exit` | Exit the CLI |
| `Ctrl+C` | Stop streaming / exit |
| `Ctrl+E` | Expand last collapsed output |
## Development
```bash
# Watch mode (auto-rebuild on changes)
npm run dev
# Manual build
npm run build
# Run without global install
node dist/index.js
```
## Updating
After pulling changes:
```bash
cd cli
npm run build
npm install -g .
```