Diana

# Diana

<img width="2752" height="1536" alt="Gemini_Generated_Image_8fewwy8fewwy8few" src="https://github.com/user-attachments/assets/c15fc35f-d90d-45c5-ad33-d17954a7f951" />

**Your Agent's Best Handler.**

Diana is the ultimate mission control for your AI agents. Just as every Agent 47 needs a Diana, every LLM needs a handler to manage directives (configuration), monitor results (outputs), and keep the budget in check (token calculation). It focuses on unified agent config management, at-a-glance token visibility, and fast in-app edits so you can adjust settings without juggling files.

> [!IMPORTANT]
> **This project is under active development.** Currently only macOS is tested and supported. Other platforms (Linux, Windows) have not been tested.

> [!IMPORTANT]
> **Always select a project directory when starting an agent session.**
>
> Token metrics are tracked per project directory. Running multiple agents on the same project directory will cause conflicts and inaccurate metrics.
>
> **Best Practice:** Use `git worktree` to create separate directories for parallel work on the same repository:
>
> ```bash
> git worktree add ../my-project-feature feature-branch
> ```
>
> This way, each agent operates in its own directory with isolated token tracking.

## Installation

### Homebrew (Recommended)

```bash
brew tap taotao7/diana
brew install --cask diana
```

This installs Diana.app to your Applications folder.

If the tap is not available yet, you can install directly from this repo:

```bash
brew install --cask https://raw.githubusercontent.com/taotao7/Diana/v0.1.1/homebrew/Casks/diana.rb
```

> **Note:** Currently only Apple Silicon (ARM64) Macs are supported.

### Download DMG

Download the latest DMG from [GitHub Releases](https://github.com/taotao7/Diana/releases).

### Build from Source

See the [Build](#build) section below.

## Features

- Multi-tab terminal emulator for running AI agents (VT100/xterm via libvterm)
- Supports Claude Code, Codex, and OpenCode
- Automatic executable detection for agents installed via nvm, Volta, asdf, Cargo, or global npm
- Provider/model configuration switching with atomic file updates
- Real-time token usage monitoring with charts
- Per-project token metrics tracking
- Config import/export for backup and sharing
- Claude Code multi-profile configuration management
- OpenCode multi-profile configuration management
- Unified Agent Config panel with tab switching and fast in-app edits
- GitHub-style activity heatmap for token usage
- Double-click session tabs to rename

## Supported Agents

| Agent       | Config Location                    | Format |
| ----------- | ---------------------------------- | ------ |
| Claude Code | `settings.json` (auto-detected)    | JSON   |
| Codex       | `~/.codex/config.toml`             | TOML   |
| OpenCode    | `~/.config/opencode/opencode.json` | JSONC  |

Providers/models can be entered directly in the configuration fields.

## Screenshots

<img width="3840" height="2224" alt="image" src="https://github.com/user-attachments/assets/dcb56de9-0299-4a36-84e1-34572bba22fc" />
<img width="3840" height="2224" alt="image" src="https://github.com/user-attachments/assets/79c3494f-cf73-499d-9c69-926936efd8a7" />

## Technology Stack

| Category         | Technology                                                                     | Purpose                            |
| ---------------- | ------------------------------------------------------------------------------ | ---------------------------------- |
| **Language**     | C++17                                                                          | Core implementation                |
| **Build System** | CMake 3.20+                                                                    | Cross-platform build configuration |
| **UI Framework** | [Dear ImGui](https://github.com/ocornut/imgui) (docking)                       | Immediate-mode GUI                 |
| **Charting**     | [ImPlot](https://github.com/epezent/implot)                                    | Real-time data visualization       |
| **Windowing**    | [GLFW](https://github.com/glfw/glfw) 3.4                                       | Cross-platform window/input        |
| **Graphics**     | OpenGL 3.3+                                                                    | Hardware-accelerated rendering     |
| **Terminal**     | libvterm                                                                       | VT100/xterm emulation              |
| **JSON**         | [nlohmann/json](https://github.com/nlohmann/json) 3.11.3                       | Config parsing, JSONL processing   |
| **TOML**         | [tomlplusplus](https://github.com/marzer/tomlplusplus) 3.4.0                   | Codex config parsing               |
| **File Dialog**  | [nativefiledialog-extended](https://github.com/btzy/nativefiledialog-extended) | Native OS file dialogs             |
| **Testing**      | [GoogleTest](https://github.com/google/googletes

... (truncated)