ThreadCellsCONTROL PLANEThreadCells
en
EnglishРусский
Docs GitHub SYSTEM READY

SELF-HOSTED CODING-AGENT OPERATIONS

Work with AI agents as a system.

ThreadCells coordinates native CLI agents, keeps open workflows moving across model turns, and maintains the orchestration environment underneath them—on your own Linux host.

View on GitHub Read the docs Start the work. Watch the system. Step in only when it needs you.
EXECUTION / tm-web-p1
LIVE
WORKFLOW SEQUENCEDSUPERVISORintent → workers → reviewer → durable result
RESIDENT 2 / 5PROVIDER 2 / 3WORK 2 / 2HEAVY 0 / 1
01COORDINATED WORKFLOWS02PROTECTED HOUSEKEEPING03DURABLE HISTORY04LOOPBACK FIRST

THE HARD PART / 02

Starting more agents is easy.
Knowing what is true is not.

Which process owns the worktree? Which session is only idle—and which one is finished? Is the machine out of provider capacity, work contexts, or heavy execution? Did the reviewer return a result, or just stop printing?

tm-83A1SUPERVISORRUNNINGprovider 01 / 03
tm-94C2WORKERCOMPLETEresult persisted
tm-07F4REVIEWERREADYcontext 02 / 02
OWNER GATEAUTHORITYGATEDdecision required

THE CONTROL PLANE / 03

One place to see the work,
the host, and the handoff.

ThreadCells wraps native agent execution in an operational surface: sessions, projects, terminals, profiles, capacity, workflows, documentation, optional global Telegram lifecycle alerts, and current build identity.

HOME / EXECUTION OVERVIEWReal release system · sensitive material excluded
01

Session truthProvider, profile, lifecycle, project, and active work remain visible.

02

Operational scaleFirst, Last, and Total summaries keep large durable histories readable.

CORE IDEAS / 04

A control room built around
the failure modes that matter.

01

Operational truth

See what is resident, executing, waiting, draining, blocked, or actually complete—without inferring state from a terminal tab.

02

Worktree authority

Anchor work to trusted projects and managed Git worktrees. Writer leases keep concurrent mutation explicit.

03

Durable results

Delegated work returns a persisted result that can be delivered, acknowledged, accepted, and retired without losing history.

04

A healthy agent environment

ThreadCells watches host pressure and safely cleans eligible runtime, log, cache, build, and release debris while protecting active work and durable history.

WORKFLOW / 05

Intent goes out.
Evidence comes back.

The coding agent stays native. ThreadCells makes the surrounding lifecycle explicit.

  1. 01

    Create a session

    Choose a trusted local project and an agent or supervisor profile.

  2. 02

    Give it the job

    A supervisor can delegate coherent work to native CLI workers and reviewers.

  3. 03

    Watch the system

    ThreadCells keeps the workflow moving across model turns while sessions, worktrees, capacity, and host pressure stay visible.

  4. 04

    Step in when asked

    Results return durably. Owner gates pause only for decisions that genuinely need you.

LIVE RELEASE TOUR

See the control plane in motion.

A short tour through the real release system: dense Home state, an expanded multi-agent session, protected Housekeeping, and independent capacity.

PRODUCT EXPERIENCE / 06

The workflow and the host,
in one operating view.

Open the real session behind the summary, keep the runtime healthy, and route high-signal owner attention without losing durable context.

SESSION / MULTI-AGENT WORKFLOWReal profiles, lifecycle, and durable completion
HOUSEKEEPING / SERVER CAREPlan, revalidate, protect active work
TELEGRAM / OWNER ATTENTIONOne low-noise installation-global route

NATIVE BY DESIGN / 07

Keep the coding agent.
Add the operating system around it.

ThreadCells drives native provider CLIs in real tmux terminals. Provider adapters report what the installed host genuinely supports; unsupported capabilities stay visible instead of being simulated.

  • Codex reference adapter and first-class Claude Code adapter
  • Provider-native authentication remains with the operator
  • Profiles and provider configuration are versioned control-plane artifacts

MACHINE OWNERSHIP / 08

Your host.
Your terminals.
Your control.

ThreadCells is self-hosted and loopback-first. It coordinates powerful local tools; it does not pretend a worktree is a security sandbox or promise hostile multi-tenancy.

Loopback firstSSH-tunnel access is the supported preview boundary.Real terminalsInspectable tmux sessions, not hidden disposable jobs.
APACHE
2.0

OPEN SOURCE

Inspect the control plane you trust with the machine.

ThreadCells is available under Apache License 2.0, with upstream attribution preserved in the appropriate legal and provenance materials.

READY / 09

Stop guessing what the agents are doing.

Run the work. See the machine. Keep the result.

View on GitHub Open Quick Setup