Metadata-Version: 2.5
Name: jarvix
Version: 0.2.2
Summary: Talk to your agent(s)
Project-URL: Homepage, https://github.com/loctvl842/jarvix
Project-URL: Repository, https://github.com/loctvl842/jarvix
Project-URL: Issues, https://github.com/loctvl842/jarvix/issues
Author-email: loctvl842 <loclepnvx@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,cli,multiplexer,tmux
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Requires-Dist: jarvix-core>=0.2.2
Provides-Extra: all
Requires-Dist: jarvix-cli>=0.2.2; extra == 'all'
Requires-Dist: jarvix-harness>=0.2.2; extra == 'all'
Requires-Dist: jarvix-hub>=0.2.2; extra == 'all'
Requires-Dist: jarvix-mux>=0.2.2; extra == 'all'
Provides-Extra: cli
Requires-Dist: jarvix-cli>=0.2.2; extra == 'cli'
Provides-Extra: harness
Requires-Dist: jarvix-harness>=0.2.2; extra == 'harness'
Provides-Extra: hub
Requires-Dist: jarvix-hub>=0.2.2; extra == 'hub'
Provides-Extra: mux
Requires-Dist: jarvix-mux>=0.2.2; extra == 'mux'
Description-Content-Type: text/markdown

# Jarvix

**Talk to your agent(s).**

One coding agent is a great assistant. A dozen of them is a team, and a team needs a way to work together.

Jarvix turns a crowd of terminal agents into one coordinated crew. Launch them together, see what each one is doing, and stop juggling tabs to work out who is busy, who is stuck, and who needs you.

## Why Jarvix

- **See everything at a glance.** Every agent reports what it is doing, so you always know who is working, who is idle, and who is waiting on you.
- **Never miss a blocked agent.** When an agent needs your approval, it asks for your attention and you jump straight to it.
- **Shape your team.** Chain agents, fan work out in parallel, and route it conditionally, all in a few readable lines.
- **Stay in your terminal.** No new app to learn. Your agents live in plain tmux panes you can attach to and watch whenever you like.
- **Safe by design.** Each team runs on its own private tmux server, so your own sessions are never touched.

## Install

```sh
uv add jarvix
```

This is all your graph needs. To run it, add the command as a dev dependency:

```sh
uv add --dev "jarvix[cli]"
```

Requires Python 3.12+, and tmux for running.

## Stopping a mesh

```sh
jarvix mesh down                 # stop the hub and kill the tmux server; your data is kept
jarvix mesh down --purge         # also delete the mesh's data (asks first, -y to skip)
```

Detach from the panes with `ctrl-b d` to leave the mesh running. A mesh's data (database, log, settings) lives in `~/.local/state/jarvix/<mesh>/`, and `--purge` removes that whole directory.

## Learn more

- [Mux](packages/mux/README.md) - spawning and arranging agent panes
- [Hub](packages/hub/README.md) - tracking what every agent is doing, and passing messages between them
- [Harness](packages/harness/README.md) - everything specific to one coding agent CLI

## Status

Jarvix is in early development and moving fast.
