https://github.com/txtx/axel-app
Peaceful task list meticulously crafted for Agents in war mode.
https://github.com/txtx/axel-app
claude-code codex git llm tmux worktree-manager
Last synced: about 1 month ago
JSON representation
Peaceful task list meticulously crafted for Agents in war mode.
- Host: GitHub
- URL: https://github.com/txtx/axel-app
- Owner: txtx
- Created: 2026-01-29T17:22:08.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-13T04:15:40.000Z (about 1 month ago)
- Last Synced: 2026-02-13T12:30:32.410Z (about 1 month ago)
- Topics: claude-code, codex, git, llm, tmux, worktree-manager
- Language: Swift
- Homepage: https://axel.build
- Size: 9.22 MB
- Stars: 99
- Watchers: 0
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
![Surfpool is the best place to train before surfing Solana]()
Axel is for anyone who wants the **calm** of a task list and their agents in **war mode** — without losing track of what's running, where, or why.
It pairs a native macOS app with a fast [RUST CLI](https://github.com/txtx/axel) to orchestrate many AI agents across tmux panes, Ghostty based terminals, and git worktrees — with a user interface inspired by **Things**.
> [!IMPORTANT]
> Axel is currently in beta and may have bugs. Contributions and bug reports are welcome.
---
## What Axel Feels Like
- A clean, Things‑like inbox for tasks and priorities.
- A living map of your active agents, each anchored to a worktree and terminal.
- A system that literally makes “spin up another agent in a new git worktree” feel as cheap as “open a new tab.”
---
## What Axel Does
Axel turns agent work into a first‑class workflow:
- **Tasks with intent**: queue, run, and complete agent tasks with status, priority, and context.
- **Real terminals**: manage live sessions (Claude, Codex, etc.) in tmux panes and Ghostty.
- **Worktree‑first isolation**: one agent, one branch — no more stepping on each other.
- **Inbox & permissions**: see agent requests in a single stream and approve quickly.
- **Skills & context**: reusable prompts from `./skills` and `~/.config/axel/skills`.
- **Sync built‑in**: Automerge CRDT + Supabase for conflict‑free collaboration.
---
## How Axel Works (Short Version)
1. You create a task in the app.
2. Axel spawns a terminal session via the CLI.
3. The agent runs in tmux, optionally inside a new git worktree.
4. The app shows live output, events, and permission prompts.
5. When the work is done, you close the loop and ship.
---
## Components
**Native macOS app (SwiftUI)**
- Five‑column workspace layout for tasks, inbox, terminals, skills, and team.
- SSE inbox for real‑time agent events and permission requests.
- SwiftData + Automerge for local state + cross‑device sync.
**Axel CLI (Rust)**
- Launches tmux grids and agent panes.
- Reads `AXEL.md` layouts and skills.
- Manages worktrees and session recovery.
**Terminal layer**
- Ghostty for fast, modern terminal emulation.
- tmux for pane orchestration.
- git worktrees for clean agent isolation.
---
## Quick Start
Requirements: macOS 14+, Xcode 15+ (for app), Rust (for CLI dev)
```bash
# Open the app in Xcode
open Axel.xcodeproj
# Run the app (Debug)
./run.sh
```
When you launch Axel, it can install the CLI to `~/.local/bin` if it isn’t already present.
---
## A Typical Flow
```text
1. Create a task “Refactor API caching”
2. Assign it to Claude in a new worktree
3. Claude runs in tmux + Ghostty
4. Permission requests appear in Inbox
5. Review output, merge, and mark done
```
---
## Project Structure (Partial)
```
Axel/
├── Views/macOS/ # macOS UI (tasks, inbox, terminals)
├── Services/ # SSE inbox, sync, CLI orchestration
├── Models/ # SwiftData entities
Packages/
├── GhosttyKit/ # terminal emulation
├── AutomergeWrapper/ # CRDT sync wrapper
```
---
## Contributing
We want Axel to feel like a tool you *want* to use daily.
Here’s what we value in contributions:
- **Workflow‑first**: every feature should reduce mental overhead for multi‑agent work.
- **Beautifully restrained UI**: clarity and delight, never clutter.
- **Terminal authenticity**: real tmux panes, real worktrees, no fakery.
- **Performance**: fast startup, fast rendering, fast agent recovery.
If you’re interested, open an issue or send a PR with:
- a short problem statement
- a proposed solution
- any design notes or workflow details
---
## Related Experiments
We’ve built other systems in this space (not necessarily good, but useful lessons):
- https://github.com/txtx/surfpool
- https://github.com/txtx/moneymq
---
## Status
Axel is under active development. The core workflow is here, and we’re making it sharper every week.
---
See `CLAUDE.md` for workspace‑specific notes.