aether-wisp 0.7.2

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
77
78
79
80
81
82
83
84
85
86
87

# wisp

A terminal interface for AI coding agents, built on the Agent Client Protocol (ACP) v2.

Wisp launches an ACP-compatible agent as a subprocess, streams markdown responses and tool activity, and provides built-in session management, file attachments, plan review, git review, and settings without leaving the terminal.

## Quick start

```bash
cargo install aether-wisp
wisp                       # launches the default agent ("aether acp")
wisp --agent "my-agent"    # launches a custom ACP agent
```

The `--agent` flag accepts any shell command that speaks ACP v2 over stdio.

## Keybindings

| Key | Action |
| --- | --- |
| `Enter` | Send message |
| `Esc` | Cancel the active operation |
| `Ctrl+C` twice | Exit |
| `Tab` | Cycle reasoning effort |
| `Shift+Tab` | Cycle mode/profile |
| `/` | Open command picker |
| `@` | Open file picker |
| `Ctrl+G` | Toggle git review |
| `Ctrl+R` | Search prompt history when supported |

Global bindings can be overridden in Wisp settings.

## Commands

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

| Command | Description |
| --- | --- |
| `/clear` | Clear the conversation and start a new session |
| `/settings` | Open settings and authentication |
| `/resume` | Resume a previous session |

The connected agent may advertise additional commands.

## Settings and themes

UI preferences are stored in `~/.wisp/settings.json`. Set `WISP_HOME` to use a different configuration directory. Supported settings include themes, content padding, status-line segments, and global keybindings.

Choose a Clankerdiff built-in theme in `/settings`, or place versioned Clankerdiff JSON theme files in `~/.wisp/themes/`. A built-ins use `{"source":"builtin","id":"sage"}`; custom uses the JSON filename:

```json
{
  "theme": { "source": "file", "file": "my-theme.json" },
  "keybindings": {
    "toggleGitDiff": "ctrl+d"
  }
}
```

Agent-provided options such as model, reasoning effort, modes, provider login, and MCP server authentication are available through `/settings`.

## Logs

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

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

Use `RUST_LOG` to configure verbosity.

## Library API

Build the API documentation with:

```bash
cargo doc -p aether-wisp --open
```

The primary public entry points are:

- `run_tui` — connect to an ACP agent and launch Wisp
- `run_with_session` — launch Wisp with an initialized `Session`
- `Session` — an initialized ACP session
- `UiSettings` and the `settings` module — persistent UI configuration

The `testing` feature exposes Wisp's in-memory integration harness for project tests.