Download · v2.8.1
Download archeus
archeus is a pure-Python package with no runtime dependencies. Any of these takes one line, and none of them needs an API key — it uses the Claude Code authentication you already have.
pipx install archeus
archeuspip install archeus
archeus/plugin marketplace add babarmuhammad/archeus
/plugin install archeus@archeusPython 3.10 or newer, no runtime dependencies, and no API key — archeus uses the Claude Code authentication you already have. Every tagged build is also on the releases page.
pipx — recommended
Installs into its own environment and puts one command on your PATH.
pipx install archeus archeusUpgrade later with pipx upgrade archeus, or from the Updates screen inside archeus.
pip
pip install archeus archeusUse a virtual environment if you would rather not install into your system Python. The package installs one console script, archeus.
npx — without installing it first
You already have npm if you installed Claude Code with it.
npx archeusThe npm package is a launcher rather than a copy of the tool: it runs archeus if it can find it, and if it cannot, it prints the exact command and hands the install to pipx — or to pip, inside a virtualenv or when pipx is missing. On Windows it also covers the case where pip has installed archeus but its Scripts directory is not on your PATH: it runs it as a module and tells you which directory to add.
Claude Code plugin
If you would rather stay inside the session.
/plugin marketplace add babarmuhammad/archeus /plugin install archeus@archeusThe plugin ships commands and skills. It deliberately ships no hooks: archeus’s own hook manager already places the recall, worklog and guard hooks per account, and giving one settings.json entry two owners means installing both runs the same hook twice.
From a git checkout
git clone https://github.com/babarmuhammad/archeus.git cd archeus python claude-sessions.py # terminal UI python claude-sessions.py --gui # desktop GUIThere is nothing to build. A checkout is told to git pull when it updates itself, rather than having a release installed over it.
What a release contains
- The archeus package: the terminal UI, the desktop GUI, the memory engine, the connections engine and the hook, agent and skill managers.
- Bundled starter skills and 31 hook templates.
- The Claude Code plugin manifest, with commands and skills generated from the package so they cannot fall behind it.
- A signed source distribution and a wheel on PyPI. Versioning is semantic; the changelog follows Keep a Changelog.
- The npm launcher, and the name on RubyGems, crates.io and NuGet — those three are pointers that print the pipx line rather than installing anything, so the name resolves to this project wherever people look for it.
Requirements
Python 3.10 or newer Claude Code The CLI, auto-detected on PATH or at ~/.local/bin/ Runtime dependencies None — Python standard library only Optional PyQt6, for the native desktop window. Without it the GUI opens in your browser over loopback. Platforms Windows, macOS and Linux; CI tests all three Licence MIT