https://github.com/nek0der/limpid
A macOS-native terminal for the AI coding agent era
https://github.com/nek0der/limpid
ai-agent ghostty libghostty macos swiftui terminal
Last synced: 10 days ago
JSON representation
A macOS-native terminal for the AI coding agent era
- Host: GitHub
- URL: https://github.com/nek0der/limpid
- Owner: nek0der
- License: mit
- Created: 2026-05-21T10:30:14.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-06-01T01:27:57.000Z (16 days ago)
- Last Synced: 2026-06-01T03:24:28.885Z (16 days ago)
- Topics: ai-agent, ghostty, libghostty, macos, swiftui, terminal
- Language: Swift
- Size: 4.07 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Limpid
[](LICENSE)
[](https://github.com/nek0der/limpid/actions/workflows/ci.yml)
[](https://github.com/nek0der/limpid/releases/latest)
> A calm, native macOS terminal with agent-aware worktrees, built on libghostty.
## Why Limpid
- **Three-column sidebar** — container / tab / terminal stays calm; no nested gimmicks.
- **⌘J jumps to whoever is waiting** — Claude, Codex, or anything that finishes a turn.
- **Worktrees are first-class** — every branch gets its own space, automatically.
- **Native macOS 26** — Liquid Glass toolbar, Sparkle updates, en + ja.
## Features
### Next-attention cursor (⌘J)
Across every tab and pane, ⌘J jumps to the next agent waiting on you. The Waiting list at the bottom of the sidebar shows the queue in priority order.
### Worktrees as first-class containers
Each git worktree gets its own space. Tabs, panes, and agent sessions stay isolated per branch. When Claude `cd`'s into another worktree mid-session, Limpid follows automatically — the matching row activates without you reaching for the mouse.
### Claude Code & Codex, together
Both CLIs are recognized natively, with live status, prompt-aware tab names, and per-pane session resume that survives restarts — including the actual scrollback, not just session IDs.
### Designed to disappear
A native macOS three-pane sidebar plus a Liquid Glass toolbar — calm, out of the way, native.
## Shortcuts
| Shortcut | Action |
|---|---|
| ⌘J | Jump to next waiting agent |
| ⌥⌘N | New worktree |
| ⌘T | New tab |
| ⌘W | Close pane |
| ⇧⌘P | Command palette |
| ⌘1…⌘9 | Jump to tab N |
| ⌘, | Settings |
All bindings live in `Settings → Keyboard` and are layout-agnostic.
## Install
[Latest DMG](https://github.com/nek0der/limpid/releases/latest) — drag `Limpid.app` to `/Applications`. Sparkle handles updates from then on.
Building from source: [CONTRIBUTING.md](CONTRIBUTING.md#setup).
## Status
Pre-alpha. macOS 26 (Tahoe) and Apple Silicon required. Patch releases per feature — see [Releases](https://github.com/nek0der/limpid/releases).
## Documentation
- [ARCHITECTURE.md](ARCHITECTURE.md) — module map, load-bearing
files, invariants, and the "How to add X" walkthroughs for new
tab kinds, container kinds, settings sections, keyboard
shortcuts, and agents.
- [AGENTS.md](AGENTS.md) — repo conventions + Swift style
(works for humans and agents).
- [CONTRIBUTING.md](CONTRIBUTING.md) — setup, build, PR
workflow.
- [SECURITY.md](SECURITY.md) — vulnerability reporting policy.
## Contributing
PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md). Questions and ideas go in [Discussions](https://github.com/nek0der/limpid/discussions).
## Acknowledgements
Built on [Ghostty](https://github.com/ghostty-org/ghostty) (libghostty) and [Sparkle](https://github.com/sparkle-project/Sparkle). The full third-party list is in [THIRD-PARTY-NOTICES](THIRD-PARTY-NOTICES).
## License
[MIT](LICENSE) © 2026 nek0der