cli_engineer 2.0.0

An autonomous CLI coding agent
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

# cli_engineer

Agentic CLI for software engineering automation. It features pluggable LLM providers, task interpretation, planning, execution, review and an agentic loop.

## Quick Start

### Installation

```bash
cargo install cli_engineer
cli_engineer --help
```

### Basic Usage

cli_engineer provides specialized commands for different types of software engineering tasks:

```bash
# Code generation
cli_engineer code "create a full-stack task management app with React frontend, Node.js/Express backend, PostgreSQL database, user authentication, and REST API"

# Code review and analysis
cli_engineer review "focus on error handling and performance"

# Documentation generation
cli_engineer docs

# Security analysis
cli_engineer security

# Refactoring assistance
cli_engineer refactor "improve code organization and performance"
```

### UI Options

**Dashboard UI (Default)** - Interactive real-time interface with metrics and progress tracking:
```bash
# Dashboard with live metrics (default behavior)
cli_engineer docs "document the architecture"

# Dashboard + File Logging - logs appear in UI AND saved to file
cli_engineer -v security "analyze code security"
# Creates: cli_engineer_YYYYMMDD_HHMMSS.log with all session details
```

**Simple Text Mode** - Traditional command-line output:
```bash
# Simple text output (disable dashboard)
cli_engineer --no-dashboard docs "document the architecture"

# Simple text + File logging
cli_engineer --no-dashboard -v review "analyze code quality"
```

**Key Features:**
- 🎛️ **Dashboard UI**: Default experience with real-time metrics, progress bars, and live log display
- 📄 **Simple Text**: Clean terminal output for scripts or minimal environments
- 📝 **File Logging**: Verbose mode (`-v`) automatically creates timestamped session logs
- 🔄 **Dual Output**: Dashboard mode with verbose shows logs in UI AND saves to file simultaneously

## Documentation

 **For comprehensive guides and detailed information, see the [docs/](./docs/) directory:**

- **[Documentation Home](./docs/index.md)**: Your starting point for all `cli_engineer` documentation.
- **[Quick Start](./docs/quick_start.md)**: Get `cli_engineer` up and running in minutes.
- **[User Guide](./docs/user_guide.md)**: Comprehensive guide to installation, configuration, and usage.
- **[Architecture Overview](./docs/architecture.md)**: Understand the system design, core components, and agentic loop.
- **[Command Reference](./docs/command-reference.md)**: Detailed information on all CLI commands.
- **[LLM Providers](./docs/llm_providers.md)**: Information on supported Large Language Models.
- **[Contributing Guide](./docs/contributing.md)**: Learn how to contribute to the `cli_engineer` project.

## Command Reference

| Command | Purpose | Output |
|---------|---------|--------|
| `code` | Generate new code | Source files in current directory |
| `review` | Analyze existing code | `code_review.md` with findings |
| `docs` | Generate documentation | Documentation files in `docs/` |
| `security` | Security analysis | `security_report.md` with vulnerabilities |
| `refactor` | Code improvement | Refactored source files |

## Developer Setup

```bash
git clone https://github.com/trilogy-group/cli_engineer
cd cli_engineer
cargo build
cargo test
```

## Features

- 🤖 **4 LLM Providers**: OpenAI (Responses API), Anthropic (Claude 4), Google Gemini, Ollama (local)
- 🧠 **Real-Time Thinking**: Live reasoning traces from Claude 4, Gemini, and local models; reasoning summaries from o1/o3/o4-mini
- 📊 **Dashboard UI (Default)**: Interactive interface with streaming thoughts and cost tracking
- 📝 **Smart Buffering**: Intelligent chunking at sentence boundaries for smooth reasoning display
- 💰 **Accurate Costs**: Real-time token usage and cost calculation from streaming events
- 🔄 **Agentic Loop**: Iterative planning, execution, and review with transparent reasoning
- 🔒 **Local Option**: Ollama support for privacy-focused, offline LLM inference (no API keys)
- 📁 **Smart Artifacts**: Context-aware file generation with proper restrictions
- 🔒 **Command-Specific Behavior**: Different file permissions and outputs per command type
- 📖 **Comprehensive Documentation**: Auto-generated docs with examples and API references

---

See the [User Guide](./docs/user-guide.md) for detailed setup and advanced usage instructions.