copex 1.0.4

Copilot Extended - AI assistant CLI with chat, plan, and ralph modes
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

# Copex - Copilot Extended

[![Crates.io](https://img.shields.io/crates/v/copex.svg)](https://crates.io/crates/copex)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A fast, native CLI for GitHub Copilot with extended features: plan-and-execute workflows, Ralph Wiggum loops, and tool execution.

## Features

- 🚀 **Native Performance** - Written in Rust for speed and reliability
- 💬 **Chat Mode** - Interactive conversations with AI models
- 📋 **Plan Mode** - Multi-step task planning with automatic execution
- 🔁 **Ralph Mode** - Iterative AI loops that keep trying until success
- 🛠️ **Tool Execution** - Create files, view content, run bash commands
- 🎨 **Rich UI** - Syntax highlighting, streaming output, themes
- 💾 **Session Management** - Save and restore conversation history
- 🔌 **MCP Support** - Connect to external tool servers

## Installation

From crates.io:
```bash
cargo install copex
```

From source:
```bash
git clone https://github.com/Arthur742Ramos/copex
cd copex
cargo build --release
./target/release/copex --version
```

## Prerequisites

- [GitHub Copilot CLI](https://docs.github.com/en/copilot) installed and authenticated
- Active Copilot subscription

## Quick Start

### Chat - Simple Conversations
```bash
# Quick question
copex chat "Explain async/await in Rust"

# With specific model
copex chat "Write a binary search" --model gpt-5.2-codex

# With reasoning
copex chat "Complex problem" --model claude-opus-4.5 --reasoning high
```

### Plan - Multi-Step Workflows
```bash
# Generate and execute a plan
copex plan "Build a REST API with tests" --execute

# Review plan before executing
copex plan "Refactor auth module" --review

# Save plan for later
copex plan "Large feature" --output plan.json

# Resume from step 3
copex plan --load plan.json --execute --from-step 3
```

### Ralph - Iterative Until Success
```bash
# Keep trying until all tests pass
copex ralph "Fix the failing tests" --max-iterations 30

# With completion promise
copex ralph "Build feature X" --promise "ALL TESTS PASSING"
```

### Interactive Mode
```bash
copex interactive
```

### Session Management
```bash
# List sessions
copex session list

# Save current session
copex session save my-project

# Resume session
copex session load my-project
```

## Configuration

Create `~/.config/copex/config.toml`:
```toml
default_model = "gpt-5.2-codex"
default_reasoning = "high"
ui_theme = "monokai"

[retry]
max_retries = 5
base_delay_ms = 1000
```

## Models

```bash
# List available models
copex models

# Use specific model
copex chat "..." --model claude-opus-4.5
copex chat "..." --model gpt-5.2-codex
copex chat "..." --model gemini-3-pro-preview
```

## Reasoning Levels

- `none` - No extended thinking
- `low` - Light reasoning
- `medium` - Balanced (default)
- `high` - Deep reasoning
- `xhigh` - Maximum reasoning (supported by some models)

## Migration from Python

This is a complete rewrite of [copex](https://pypi.org/project/copex/) from Python to Rust. All features are preserved with improved performance.

The Python version is archived in `archive/python-v1.1.0/`.

## License

MIT