Skip to content
archeus

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 — recommended
pipx install archeus
archeus
pip
pip install archeus
archeus
Claude Code plugin
/plugin marketplace add babarmuhammad/archeus
/plugin install archeus@archeus

Python 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.

  1. pipx — recommended

    Installs into its own environment and puts one command on your PATH.

    pipx install archeus
    archeus

    Upgrade later with pipx upgrade archeus, or from the Updates screen inside archeus.

  2. pip

    pip install archeus
    archeus

    Use a virtual environment if you would rather not install into your system Python. The package installs one console script, archeus.

  3. npx — without installing it first

    You already have npm if you installed Claude Code with it.

    npx archeus

    The 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.

  4. Claude Code plugin

    If you would rather stay inside the session.

    /plugin marketplace add babarmuhammad/archeus
    /plugin install archeus@archeus

    The 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.

  5. 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 GUI

    There is nothing to build. A checkout is told to git pull when it updates itself, rather than having a release installed over it.

  6. 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.
  7. Requirements

    Python3.10 or newer
    Claude CodeThe CLI, auto-detected on PATH or at ~/.local/bin/
    Runtime dependenciesNone — Python standard library only
    OptionalPyQt6, for the native desktop window. Without it the GUI opens in your browser over loopback.
    PlatformsWindows, macOS and Linux; CI tests all three
    LicenceMIT