Metadata-Version: 2.4
Name: hive-ide
Version: 1.0.1
Summary: An agent-aware tmux workspace for coding agents
Author: Meli Hive
License-Expression: MIT
Project-URL: Homepage, https://github.com/melihive/hive-ide
Project-URL: Changelog, https://github.com/melihive/hive-ide/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/melihive/hive-ide/issues
Project-URL: Source, https://github.com/melihive/hive-ide
Keywords: ai-agents,claude-code,codex,terminal,tmux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Provides-Extra: release
Requires-Dist: build>=1.2; extra == "release"
Requires-Dist: twine>=6; extra == "release"
Dynamic: license-file

# hive-ide

An agent-aware tmux workspace for running coding agents across multiple sessions.

> **Status: stable.** Version 1.x follows semantic versioning for its public interfaces.

## Requirements

Unix (Linux/macOS), `tmux`, and Python 3.10+.

## Install

```sh
python3 -m pip install hive-ide
hive-ide create --name=MAIN --driver=term
hive-ide open
```

Bundled drivers are `claude`, `codex`, `antigravity`, and `term`. State is user-local and
directory-scoped. Agent drivers require their corresponding local command; `term` opens a
regular shell.

An existing Git worktree is just a session working directory. The IDE attaches to it but
never creates, merges, or removes it:

```sh
hive-ide create --name=FEATURE --driver=codex --working-dir=../project-feature
hive-ide working-dir-set --session-id=<ID> --working-dir=../project-feature
```

The sidebar marks linked worktrees as clean, modified, missing, or unknown.

Reopen the current session's plan or resume its recorded agent conversation:

```sh
hive-ide current-plan
hive-ide current-chat
```

Both commands use `HIVE_IDE_SESSION_ID` inside the frame, or accept
`--session-id=<ID>`. They target the session pane when its frame is running and
otherwise open in the current terminal.

Local settings live in `~/.config/hive-ide/config.json` (or `HIVE_IDE_CONFIG`).
The plan editor accepts any command string or argv list. Resolution is configured
editor, `HIVE_IDE_EDITOR`, `micro` when installed, then `less`:

```json
{
  "editor": "nvim --clean",
  "keys": {
    "prefix": "C-a",
    "bindings": {"next": "n", "previous": "p", "error": null}
  },
  "sidebar": {
    "state": "activity",
    "slots": ["plan", "checkout", "ci"],
    "providers": {
      "ci": {
        "region": "slot",
        "source": "session",
        "path": ["host", "ci", "state"],
        "icons": {"passing": "✓", "failing": "❌"}
      }
    },
    "icons": {
      "drivers": {"codex": "C"},
      "providers": {"checkout": {"live": "W"}}
    }
  }
}
```

Sidebar symbols may occupy one or two terminal cells. `state` selects one mutually
exclusive provider; `slots` is an ordered list and may contain any number of columns.
Additional field providers can be declared in config. Python entry points in
`hive_ide.sidebar_providers` may contribute the same normalized field definitions; pane
processes read only the resulting JSON snapshot and never import plugin code.

Create managed stable and editable development environments, then switch one session
without affecting the others:

```sh
hive-ide environment-setup --dev-checkout=.
hive-ide source-set --session-id=<ID> --source=dev
hive-ide source-set --session-id=<ID> --source=stable
```

Preview machine-global Claude and Codex status hooks before applying them:

```sh
hive-ide hook-setup
hive-ide hook-setup --apply
```

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

MIT. See [LICENSE](LICENSE).

## About

`hive-ide` is part of [Meli Hive](https://melihive.com). It is being built as a standalone
MIT-licensed project with no dependency on the rest of the platform.
