aether-wisp 0.1.0

A terminal UI for AI coding agents via the Agent Client Protocol (ACP)
Documentation 
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

# Wisp

A TUI for AI coding agents via the Agent Client Protocol (ACP).

## Install

```bash
cargo install --path packages/wisp
```

## Run

```bash
wisp
```

## Keybindings

| Key | Action |
|-----|--------|
| `Enter` | Send message |
| `Esc` | Cancel |
| `Ctrl+C` | Exit |
| `Tab` | Cycle reasoning effort |
| `Shift+Tab` | Cycle mode/profile |
| `/` | Command picker |
| `@` | File picker |
| `Ctrl+G` | Toggle git diff |

## Slash Commands

Type `/` in the input to open the command picker. Built-in commands:

| Command | Description |
|---------|-------------|
| `/clear` | Clear screen and start a new session |
| `/settings` | Open settings overlay |
| `/resume` | Resume a previous session |

Additional commands may be available from the agent (e.g., `/search`, `/web`).

## Logs

Debug logs are written to `/tmp/wisp-logs/wisp.log.YYYY-MM-DD` by default. Override with:

```bash
wisp --log-dir ~/logs
```

## Settings

Wisp has two kinds of settings:

1. **Wisp settings** (`~/.wisp/settings.json`) — UI preferences like themes
2. **Agent settings** — Model, reasoning effort, MCP servers, etc. These come from the agent and are configured in-app via `/settings`

Override the Wisp home directory with `WISP_HOME` environment variable.

### Themes

Place `.tmTheme` files in `~/.wisp/themes/`:

```bash
mkdir -p ~/.wisp/themes
curl -o ~/.wisp/themes/catppuccin.tmTheme https://example.com/catppuccin.tmTheme
```

Then set in `~/.wisp/settings.json`:

```json
{
  "theme": { "file": "catppuccin.tmTheme" }
}
```

Remove `"file"` or set it to `null` to use the default theme.