Thread Manager for Amp
https://github.com/block/thread-manager-for-amp- Category
- AI Agents
- Rank
- No. 1707Tools index
Previous survey · No. 1713 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- block
- GitHub
- 6 stars
- Date
About
A local web UI for managing Amp AI coding agent threads.
What it does
It gives Amp operators one control room for concurrent coding sessions. Users can stream output, open shell terminals, search conversations, inspect Git activity, track blockers, assign labels, arrange work on a Kanban board, and continue work through handoffs. Local SQLite storage keeps organizational metadata beside Amp’s existing thread records.
Why it's ranked here
Its case rests on unusually broad operational coverage. The tool combines live interaction, thread organization, source control context, search, and handoff tracking instead of stopping at session browsing. That breadth is valuable for developers juggling several repositories or tasks, though the source-based setup and strict local focus narrow its audience.
What's good
Thread relationships receive serious treatment: blockers, parent-child handoff chains, shared-file discovery, and correlated commits or branches help explain how sessions connect. WebSocket reconnection resumes output after drops. Table, card, and Kanban views support different planning styles, while bulk operations reduce cleanup work. The modal foundation also includes focus trapping and focus restoration.
Tradeoffs
Setup requires Node.js 24 or newer, pnpm 10 or newer, and an installed, authenticated Amp CLI. Two native dependencies require compilation and may need platform build tools. The server binds only to localhost, so it does not serve as a shared or remote dashboard. Organizational metadata and Amp thread data also live in separate stores.
How to use it well
Use it when one developer runs several Amp sessions across repositories and needs a daily control surface for triage, continuation, Git inspection, and cleanup. Status columns, blockers, labels, search, and handoffs become most useful when applied consistently. It does not replace hosted team coordination, remote monitoring, or Amp itself.
Technical notes+
package.json defines a private TypeScript ES module application built with pnpm, React 19, Vite, Vitest, better-sqlite3, ws, xterm.js, and node-pty. README.md describes a raw Node.js HTTP backend with REST and WebSocket interfaces plus SQLite metadata storage. src/App.tsx composes filtering, thread lists, terminal management, bulk actions, and modal workflows. src/api/client.ts centralizes JSON HTTP verbs, error conversion, abort handling, and a 30-second default timeout. src/components/BaseModal.tsx implements portal rendering, Escape handling, optional overlay closing, focus trapping, initial focus, and focus restoration.
Observed
- License
- Apache License 2.0
- Primary language
- TypeScript
- Packaging and install
- Private pnpm application installed from source with pnpm install; requires Node.js 24+ and pnpm 10+.
- Interfaces
- Browser interface backed by local REST, WebSocket streaming, and integrated PTY terminal sessions.
- Platform support
- Native build prerequisites are documented for macOS and Linux.
- Storage
- Reads Amp thread JSON records and stores statuses, blockers, linked issues, notes, and images locally using SQLite and artifact storage.
Read from README.md, package.json, src/App.tsx, src/main.tsx, src/types.ts, src/constants.ts, src/test-setup.ts, src/api/client.ts, src/contexts/index.ts, src/commands/types.ts, src/commands/index.tsx, src/commands/categories.ts, src/components/AppModals.tsx, src/components/BaseModal.tsx, src/commands/toolsCommands.tsx.
What it can do
Create new AI coding agent threads
User request or project parameters → New thread instance
View existing thread conversations
Thread ID or selection → Thread conversation history and messages
Delete unwanted threads
Selected thread(s) → Confirmation of thread removal
Search through thread contents
Search query or keywords → Filtered list of matching threads or messages
Export thread data
Selected thread(s) → Exported thread files or data
Monitor thread status and activity
Active threads → Real-time status updates and activity indicators
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.