Know the moment one needs you.
Sessions waiting on a permission or a question rise to the top, with the exact request. A notification takes you there. Approving stays with you.
Docs siteNeeds permission: Bash: npm publish
Promptly
Every Claude session. At a glance.
The terminal built for Claude Code. Run sessions side by side, see your plan usage live, and know the moment one needs you.
Latest release. Apple silicon with macOS 14 or later, unsigned for now. Also on Linux.
Made for running agents in parallel.
Promptly runs the real Claude Code, unchanged. It listens alongside, so the right session finds you instead of you hunting for it.
Usage, live.
Your plan's 5‑hour and weekly limits, counting down to the reset.
0%5‑hour
A worktree for every session.
Parallel agents never collide. Each gets its own branch outside your checkout, and work with uncommitted changes is never removed.
Review, then reply.
See what a session changed, comment on any line, and send every comment back as one prompt.
@@ -12,6 +12,9 @@ export function server()
app.use(json())
- app.use(routes)
+ app.use(rateLimit({ perMinute: 100 }))
+ app.use(routes)
Make the limit configurable per API key.
Instant.
Hooks reach Promptly fast enough that you'll never notice them.
5.6 ms
p95 round trip, measured against Claude Code 2.1.286
Write prompts properly.
A composer for long prompts, with file completion and history.
Refactor @src/server.ts to use the limiter from @src/middleware/rate-limit.ts and add tests.
Private by design.
No account. No telemetry. Your Claude settings are never modified, and nothing listens on the network.
See your limits before they see you.
Claude Code reports your plan limits as it works. Promptly turns them into a live dashboard, with alerts at 80 and 95 percent.
Limits, counting down
5‑hour and weekly windows with the exact reset time.
Spend as it happens
Cost and burn rate for every open session.
Every session today
Tokens by hour and model, including sessions started elsewhere.
It wraps Claude Code. It doesn't replace it.
Nothing is forked or patched, so every new Claude Code release works on day one.
Start a session
Press ⌘N. Claude Code runs exactly as it does in your terminal, in its own worktree if you like.
Promptly listens
Session hooks, the status line and the transcript tell it when Claude is working, waiting, finished, or spending.
You step in
The session turns amber and rises to the top. Press ⌘J to jump straight to it.
Tech specs
- Compatibility
- macOS 14 or later on Apple silicon. Linux x86_64 and arm64, Wayland and X11. Works with any shell and any CLI.
- Claude Code
- Runs the unmodified
claudeCLI. Session-scoped hooks and status line; your own hooks and status line keep running. Verified with 2.1.286. - Terminal
- GPU rendering with Metal and Vulkan. Truecolor, Kitty keyboard protocol, OSC 8 links, bracketed paste, 100,000 lines of searchable scrollback. Shell integration for zsh, bash and fish.
- Sessions
- Attention queue and notifications, git worktree per session, fan‑out, review with comments, composer, history search and resume, command palette, scripting with
promptly-ctl. - Security
- Local Unix sockets only, each with a 256‑bit token and peer check. Clipboard reads blocked. Paste preview for hidden characters. Never approves on your behalf.
- License
- FSL-1.1-MIT. Use it, read it, change it. You can't sell a competing product with it, and every version becomes MIT two years after release.
- Updates
- Updates itself from GitHub Releases. Every download is checked against a published SHA‑256 before install.
Get Promptly.
You'll need Claude Code installed. After that, Promptly keeps itself up to date.
Mac
Apple silicon with macOS 14 or later
Download Unsigned for now, notarization is coming. One-time first-launch stepInstall from the command line
# Mac: unzip, clear the quarantine flag once, open
unzip Promptly-*-macos-arm64.zip -d /Applications
xattr -dr com.apple.quarantine /Applications/Promptly.app
open /Applications/Promptly.app
# Debian and Ubuntu
sudo apt install ./promptly_*_$(dpkg --print-architecture).deb
# From source
git clone https://github.com/martinykiriloff/promptly.git && cd promptly
cargo build --release --workspace && ./target/release/promptly
Every build is listed with its checksum on the releases page.