Metadata-Version: 2.5
Name: tabmancer
Version: 0.1.6
Summary: A terminal dashboard for coding-agent sessions (Claude Code, Codex, Antigravity): see what they are doing, run them as teams, call them back after a reboot
Project-URL: Homepage, https://github.com/SinanTufekci/tabmancer
Project-URL: Issues, https://github.com/SinanTufekci/tabmancer/issues
Project-URL: Changelog, https://github.com/SinanTufekci/tabmancer/blob/main/CHANGELOG.md
Author: Sinan Tüfekci
License-Expression: Apache-2.0 AND CC-BY-4.0
License-File: LICENSE
License-File: LICENSE-BIT
License-File: NOTICE
Keywords: claude-code,codex,coding-agents,dashboard,resume,sessions,textual,tui,windows-terminal
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: send2trash>=1.8
Requires-Dist: textual>=8.0
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/SinanTufekci/tabmancer/main/docs/banner.svg" alt="Bit, tabmancer's robot, beside a small dashboard of coding-agent sessions (one waits for you, one works, one was cut off, one stopped at a usage limit, one is done) and a chart of the tokens they used over 14 days" width="100%">
</p>

<p align="center">
  <a href="https://github.com/SinanTufekci/tabmancer/actions/workflows/tests.yml"><img src="https://github.com/SinanTufekci/tabmancer/actions/workflows/tests.yml/badge.svg" alt="tests"></a>
  <a href="https://pypi.org/project/tabmancer/"><img src="https://img.shields.io/pypi/v/tabmancer" alt="PyPI"></a>
  <img src="https://img.shields.io/pypi/pyversions/tabmancer" alt="Python 3.10+">
  <a href="https://github.com/SinanTufekci/tabmancer/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="Apache 2.0 licence"></a>
</p>

# tabmancer

**Many Claude Code sessions in many terminals: one screen for all of them, and none lost.**
tabmancer is a dashboard for your coding-agent sessions, in the terminal. See every session
from every project, which ones are working, which one waits for you and how full each one's
context is, and go to any of them in a key. Close them when you have to, even halfway through
a task: they come back where they left off, each in its own tab and folder, and the ones cut
off mid-reply carry on by themselves. Claude Code first, Codex and Antigravity if you use them.

> I run Claude Code in several terminals at once, and keeping track of them got hard: which
> one is working, which one is waiting for me. And I often had to close them before Claude
> had finished. tabmancer is what I built for both: one screen to see and manage them all,
> and every session back where it left off, all of them at once. *Sinan Tüfekci*

<p align="center">
  <img src="https://raw.githubusercontent.com/SinanTufekci/tabmancer/main/docs/demo.webp" alt="tabmancer in use: a cut-off session, a card filter, a team, the team view and the keys" width="100%">
</p>

## Try it

```sh
uvx tabmancer --demo         # made-up sessions: nothing of yours is read or changed
```

Every key works in the demo, but nothing opens and no model is asked. Then install it:

```sh
uv tool install tabmancer    # or: pipx install tabmancer
tabmancer                    # the dashboard
```

It needs Python 3.10+ and Claude Code's `claude` on your PATH. Upgrade it with
`uv tool upgrade tabmancer` (or `pipx upgrade tabmancer`): the dashboard says when a newer
version is out ([updating](https://github.com/SinanTufekci/tabmancer/blob/main/docs/setup.md#updating)). `?` lists every key and runs
the one you pick; the footer shows the common ones and what they do on the row you are on.
On Windows, `tabmancer shortcut` adds a desktop shortcut and `tabmancer startup on` opens the
picker at login when sessions were left open.

## What it does

![The dashboard: live counters, projects, recent sessions, how each one ended, and a preview with an AI summary](https://raw.githubusercontent.com/SinanTufekci/tabmancer/main/docs/picker.png)

- **Shows what each one is doing.** Every open session, whichever terminal it is in: working,
  waiting for you or needing you, the model and effort it runs on, and how full its context is;
  your plan limits in the top bar.
  `j` goes to the next one waiting for you, and `Enter` on an open one goes to its tab.
- **Brings your sessions back.** Closed before they were done, by you, a reboot or a crash,
  they say how they ended (cut off, unanswered, at a usage limit, done) and wait under TO
  CONTINUE. `Enter` opens them again where they left off, each in its own tab and folder, and
  the ones cut off mid-task are told to carry on. After a reboot the ones that were open start
  out ticked: one `Enter` brings them all back. Resume, fork or start fresh, per session.
- **Gets past a usage limit.** Sessions stopped at a limit say when it lifts; `c` continues
  them all then, or right away once you have signed in with another account.
- **Runs teams.** Several sessions on one project with an orchestrator, or as peers on related
  topics side by side, talking through Claude Code's own messaging between sessions: one row in
  the list, and a view of who tells whom what. Each member can run on its own model and effort.
- **Hands crowded sessions over.** `h` moves the work to a fresh session, with a full handover
  as its first message. A whole team too: its lead writes the handover and the line-up for the
  rest of the work, you change what you like, and the team starts again, fresh.
- **Goes easy on your plan's limit.** Every reply reads the whole conversation again, so a long
  session is where most of a limit goes. The sessions tabmancer starts keep to a context cap
  (300k unless you pick another), and in `n` a quick router suggests the model, effort and cap
  for your first message: the cheapest that will still do the work well, yours to take with
  `Ctrl+R` or leave. [The context cap](https://github.com/SinanTufekci/tabmancer/blob/main/docs/handover.md#the-context-cap).
- **Counts.** Tokens, when you work, tools and files, plan limits with a forecast, and a
  written report of the week to share.
- **Wraps your week up.** [Claude Code Wrapped](#claude-code-wrapped): your week as a card to
  post on X, Bluesky, Threads or your Instagram story.
- **Finds.** `/` finds a session by anything you or Claude said in it.
- **Codex and Antigravity too**, if you use them.

[Everything it does](https://github.com/SinanTufekci/tabmancer/blob/main/docs/features.md), and the details: [using it](https://github.com/SinanTufekci/tabmancer/blob/main/docs/using.md) (what each
status means, every key, writing to a session, background sessions, workspaces) ·
[teams](https://github.com/SinanTufekci/tabmancer/blob/main/docs/teams.md) · [handing over](https://github.com/SinanTufekci/tabmancer/blob/main/docs/handover.md) · [stats and reports](https://github.com/SinanTufekci/tabmancer/blob/main/docs/stats.md) ·
[setup and commands](https://github.com/SinanTufekci/tabmancer/blob/main/docs/setup.md) · [how it works](https://github.com/SinanTufekci/tabmancer/blob/main/docs/how-it-works.md)

## Claude Code Wrapped

<p align="center">
  <img src="https://raw.githubusercontent.com/SinanTufekci/tabmancer/main/docs/wrapped.png" alt="A Claude Code Wrapped card from the demo: I'm the Comeback Kid, 4 sessions brought back; 55.8M tokens, 14h 14m at work over 7 days, 13 sessions, 4 side by side, Claude wrote about 8 novels; Bit in confetti and the tokens of each day" width="64%">
  <img src="https://raw.githubusercontent.com/SinanTufekci/tabmancer/main/docs/wrapped-story.png" alt="The same week as a story card: every number, the models used, the longest session, the top tool and the hours of the day the work was done in" width="20%">
</p>

Your week with Claude Code as a card worth posting, drawn in pixels like Bit. On Fridays Bit
says it is ready, and `W` shows it any day: who the week made you (the Conductor, the Night
Owl, the Marathoner, the Comeback Kid and more, each with the number behind it), the tokens
against last week, the time at work, the sessions side by side, what Claude wrote in novels'
worth, the files edited, the models, the longest session and the hours you worked. `f` turns it
into a story card. `p` shares it: X, Bluesky or Threads open a new post with the words already
written and the card on your clipboard to paste in; for Instagram the story card is saved and
its folder opened, to send to your phone. Nothing is posted until you post it, and the card
holds counts only: no project names, nothing said in a session.

```sh
tabmancer wrapped --share x    # or bluesky, threads, instagram; --story saves the tall card
```

## Keys

| Key | Action |
|---|---|
| `Enter` | open the ticked sessions, or the highlighted one, each in its own tab |
| `Space` | tick a session |
| `m` | how it opens: resume → auto-continue → fork → new |
| `p` | write a prompt to a session (an open one: go to its tab) |
| `j` | the next open session waiting for you |
| `/` | find by project, title, or anything said in a session |
| `n` | fresh sessions in several projects at once; `Ctrl+R` takes the router's model, effort and cap |
| `T` | teams |
| `h` | hand a session over to a fresh one; on a team, the whole team (twice) |
| `c` | continue the sessions stopped at a usage limit |
| `u` | stats |
| `W` | Claude Code Wrapped: your week as a card; `p` shares it, `f` makes it a story |
| `?` | every key, explained; `Enter` runs the one picked |

[All the keys](https://github.com/SinanTufekci/tabmancer/blob/main/docs/using.md#keys).

## Where it runs

Built and used every day on Windows 11 with Windows Terminal: tabs, going to a session's tab,
start at login, desktop notifications and a desktop shortcut. On Linux, tabs open in tmux
(tried for real), WezTerm, kitty, GNOME Terminal and Konsole; on macOS in iTerm2 and
Terminal.app, which have not been tried on a real Mac yet. In any other terminal, tabmancer
prints the commands to run. [What has been tried where](https://github.com/SinanTufekci/tabmancer/blob/main/docs/how-it-works.md#status).
Reports are welcome.

Claude Code's formats are its own and can change between releases: after an update,
`tabmancer doctor` checks that everything tabmancer relies on still works.

## Privacy

tabmancer runs on your machine and talks to no server of its own. It reads the transcripts
the agents already keep (`~/.claude`, `~/.codex`, `~/.gemini`) and asks the `claude` CLI
which sessions are open and how full your plan limits are (`/usage`, a local command). It
reads which account you are signed in with (its email and plan) from `~/.claude.json` and
Codex's `auth.json`, to show it in the top bar, and remembers the emails of the Claude accounts it
has seen, in its own folder, to offer them when you switch (`A`), with the browser profile each
one's sign-in page opens in: for that it reads your browsers' list of profiles (each one's name
and the Google account it syncs with), never their cookies or passwords; and the ids of the sessions it
opened again, to count them on your week's card (`W`). Once a day it asks PyPI which version of
tabmancer is the latest, to tell you of a newer one (`tabmancer updates off` stops it). A model
is called only when you ask for one, through your own CLI
and plan: an AI summary (`s`), a handover (`h`; a team's lead writes its team's, `h` in the team
view), a report (`r` in the stats), a team's line-up
(`Ctrl+R` in the new-team form, which sends the goal, the project's file names and its README's
start, and the goal and members' parts of a team at work in that project). One call is made
without asking: in `n`, once you stop typing a first message, the router sends that message and
the ticked folders' names to Haiku to suggest a model, effort and context cap (`"router": false`
in its `config.json` stops it; `Ctrl+R` then asks). It types into
an open session only when you have it continue the ones stopped at a usage limit (`c`), or send
a team at work's lead the message `Ctrl+R` wrote for it (`Ctrl+S`).
Sharing your week's card (`p` on it) opens the platform's own page for a new post in your
browser, with the words written in: you post it, or not.
Nothing is sent anywhere else, and there is no telemetry.

## Trademarks

tabmancer is an independent project, not made by, affiliated with or endorsed by
Anthropic, OpenAI or Google. Claude Code, Codex and Antigravity are their owners'
trademarks; they are named here only to say what tabmancer works with.

## License

The code is licensed under the [Apache License 2.0](https://github.com/SinanTufekci/tabmancer/blob/main/LICENSE): keep the [NOTICE](NOTICE) with it and credit "tabmancer by Sinan Tüfekci". Bit, the robot, is licensed under [CC BY 4.0](https://github.com/SinanTufekci/tabmancer/blob/main/LICENSE-BIT): wherever you use it, credit "Bit by Sinan Tüfekci". Not affiliated with Anthropic.
