archeus 2.0.0__tar.gz

archeus-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Babar Muhammad Anas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

archeus-2.0.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: archeus
+Version: 2.0.0
+Summary: The workspace layer for Claude Code - persistent project memory, an interactive architecture graph, MCP awareness, and per-project launch control in a fast terminal UI
+Author: Babar Muhammad Anas
+License: MIT
+Project-URL: Homepage, https://claudectl.space
+Project-URL: Documentation, https://docs.claudectl.space/
+Project-URL: Repository, https://github.com/babarmuhammad/archeus
+Project-URL: Source, https://github.com/babarmuhammad/archeus
+Project-URL: Issues, https://github.com/babarmuhammad/archeus/issues
+Project-URL: Changelog, https://claudectl.space/changelog
+Keywords: claude,claude-code,tui,session-manager,windows,ai-agents,context-management,developer-tools,mcp,terminal-ui,workspace,session-history
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Provides-Extra: gui
+Requires-Dist: PyQt6; extra == "gui"
+Requires-Dist: PyQt6-WebEngine; extra == "gui"
+Dynamic: license-file
+
+<h1 align="center">archeus</h1>
+
+<p align="center">
+  <sub><i>Formerly <code>claudectl</code>. Everything migrates on first run —
+  settings, memory graphs and per-project state. Nothing is deleted.</i></sub>
+</p>
+
+<p align="center">
+  <b>The workspace layer for Claude Code.</b><br>
+  Your projects stop being a stream of chats and start being workspaces —
+  with memory, history, and per-project launch control.
+</p>
+
+<p align="center">
+  <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-blue">
+  <img alt="Platform" src="https://img.shields.io/badge/platform-Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-0078D6">
+  <img alt="Dependencies" src="https://img.shields.io/badge/runtime%20deps-zero%20(stdlib)-brightgreen">
+  <img alt="Tests" src="https://img.shields.io/badge/tests-1493-brightgreen">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-green">
+  <img alt="Claude Code" src="https://img.shields.io/badge/for-Claude%20Code-8A5CF6">
+</p>
+
+<p align="center">
+  <b>🌐 <a href="https://claudectl.space">claudectl.space</a>
+  &nbsp;·&nbsp;
+  📖 Full documentation → <a href="https://docs.claudectl.space/">docs.claudectl.space</a></b><br>
+  <sub>Everything below is the short version. Every feature, key binding and file is
+  documented in detail on the docs site.</sub><br>
+  <sub>
+    <a href="https://pypi.org/project/archeus/">PyPI</a> ·
+    <a href="https://claudectl.space/blog">Blog</a> ·
+    <a href="https://claudectl.space/faq">FAQ</a> ·
+    <a href="https://www.linkedin.com/in/muhammad-anas-babar-819647240">LinkedIn</a> ·
+    <a href="https://dev.to/muhammad_anasbabar_31256">dev.to</a>
+  </sub>
+</p>
+
+<p align="center">
+  <sub><i>Not the Rust <code>archeus</code>. Two independent projects share this name;
+  this one is the Python workspace layer for Claude Code.</i></sub>
+</p>
+
+<p align="center">
+  <img alt="archeus dashboard" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-dashboard.png" width="900">
+</p>
+
+---
+
+## What problem does this solve?
+
+Claude Code is excellent inside a session and forgetful between them. Every new
+session starts from nothing, your old sessions are hard to find, and the only
+way to give the agent context is a `CLAUDE.md` that grows until it costs more
+than it's worth.
+
+**archeus sits in front of Claude Code and fixes that.** Pick a project, see
+every session you've ever had in it, and launch with the model, effort,
+permissions and context you meant. Underneath, it maintains a semantic memory
+of the codebase and injects only the part relevant to what you just asked.
+
+It is a terminal UI and a desktop GUI over the same engine — use whichever you
+prefer, they do the same things.
+
+## Quickstart
+
+```bash
+pipx install archeus     # or: pip install archeus
+archeus
+```
+
+There is nothing to build and no dependencies to install. To run it from a
+checkout instead:
+
+```bash
+git clone https://github.com/babarmuhammad/archeus.git
+cd archeus
+python claude-sessions.py          # terminal UI
+python claude-sessions.py --gui    # desktop GUI
+```
+
+Requires **Python 3.10+** and the
+[Claude Code CLI](https://docs.anthropic.com/claude-code) (auto-detected on
+PATH or at `~/.local/bin/`). No API key — it uses the Claude Code auth you
+already have. No third-party packages.
+
+It also ships as a Claude Code plugin, if you'd rather stay inside the session:
+
+```
+/plugin marketplace add babarmuhammad/archeus
+/plugin install archeus@archeus
+```
+
+→ [Full install guide](https://docs.claudectl.space/installation/)
+
+## What it looks like
+
+<table>
+<tr>
+<td width="50%"><img alt="Session browser" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-sessions.png"><br>
+<sub><b>Every session, every project.</b> Search, tag, fork, resume, archive,
+export — across multiple Claude accounts at once.</sub></td>
+<td width="50%"><img alt="Project memory" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-memory.png"><br>
+<sub><b>Memory Claude built about your code.</b> Entities, relations and
+lessons, with the token cost of every block shown before you spend it.</sub></td>
+</tr>
+<tr>
+<td><img alt="Usage" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-usage.png"><br>
+<sub><b>Where the tokens went.</b> Per day, per project, per account, per
+model — read from your own transcripts, not an API.</sub></td>
+<td><img alt="Claude Code's own state" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-claude-code.png"><br>
+<sub><b>Claude Code itself, made visible.</b> Which skills and plugins you
+actually use, what is on disk, and a typed editor for every account's
+settings.</sub></td>
+</tr>
+</table>
+
+The terminal UI is the same tool, keyboard-first:
+
+<p align="center">
+  <img alt="archeus TUI — project picker" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/tui-main.png" width="49%">
+  <img alt="archeus TUI — sessions" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/tui-sessions.png" width="49%">
+</p>
+
+<p align="center">
+  <img alt="Architecture graph" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/graph-real.gif" width="820">
+  <br><sub><b>The architecture graph</b> — every module and its dependencies,
+  expandable down to single files (Python · C/C++ · C# · JS/TS).</sub>
+</p>
+
+<sub>Also: 32 palettes, 8 skins and 4 themed worlds — a skin changes the shape of the app,
+not just its colours.
+<a href="https://docs.claudectl.space/desktop/">See them →</a></sub>
+
+---
+
+## Why archeus
+
+- 🧠 **Intelligent memory, not a memory dump** — task-scoped, token-budgeted injection at the launcher: a micro-index always on (≤250 tok), per-module detail loaded only when Claude touches those files, and an optional per-prompt hook that injects just the subgraph relevant to what you asked.
+- 📚 **It learns from every session** — durable lessons (fixes, decisions, preferences) distilled from transcripts, human-reviewed, injected when relevant, decayed when stale.
+- 🕸️ **See your architecture** — an animated, expandable dependency graph that opens at the project level and drills down to single files.
+- 🩺 **Auto-solves common Claude Code pain** — pre-launch health checks, context-loss insurance after `/compact`, permission-fatigue killer, token-burn advisor, daily usage tracking.
+- 🤖 **Adaptive agents** — the right subagents suggested (or auto-applied) per project from local signals.
+- 📦 **Workspace, not chats** — browse, search, tag, fork, resume and archive every Claude Code session across every project and account.
+- ⚡ **Zero runtime dependencies** — pure Python standard library; uses your existing Claude Code auth.
+
+### How archeus saves tokens
+
+Without archeus, a big project either starves the agent (no context) or floods it (a huge CLAUDE.md loaded every message). archeus spends the *minimum* tokens for the *maximum* relevant context:
+
+- **Flat always-on cost** — the CLAUDE.md block is a ≤250-token index, not a full dump; it does **not** grow as the codebase grows.
+- **On-demand detail** — per-module knowledge lives in path-scoped `.claude/rules/`, so nothing is paid for until it's relevant.
+- **Task-scoped injection** — the optional prompt hook injects only the subgraph your prompt actually needs (budgeted, default ≤600 tok).
+- **No stale weight** — superseded facts are invalidated, dead entities evicted.
+- **Cheaper model for the grunt work** — Plan→Execute runs the expensive model once for the plan and a cheap (or free) one for execution.
+
+→ [How the token economy works](https://docs.claudectl.space/usage/)
+
+---
+
+## Documentation
+
+The full manual lives at **[docs.claudectl.space](https://docs.claudectl.space/)**.
+
+| | |
+|---|---|
+| [Getting started](https://docs.claudectl.space/getting-started/) | what it is, the three surfaces, where to go next |
+| [Installation](https://docs.claudectl.space/installation/) | pipx, pip, checkout, plugin, GUI window, Windows shortcuts |
+| [Quickstart](https://docs.claudectl.space/quickstart/) | install to first session in five minutes |
+| [Command line](https://docs.claudectl.space/cli/) | every command, for scripts and hooks |
+| [Terminal UI](https://docs.claudectl.space/tui/) | every screen and every key binding |
+| [Desktop app](https://docs.claudectl.space/desktop/) | the same workspace as a local app, plus the theme system |
+| [Configuration](https://docs.claudectl.space/configuration/) | every file archeus reads and writes, and where |
+| [Project memory](https://docs.claudectl.space/memory/) | the three injection surfaces, lessons, recall |
+| [Architecture graph](https://docs.claudectl.space/architecture/) | the interactive dependency view |
+| [Usage & cost](https://docs.claudectl.space/usage/) | measuring and cutting the per-turn cost |
+| [API reference](https://docs.claudectl.space/api/) | the local HTTP API the GUI is built on |
+| [Troubleshooting](https://docs.claudectl.space/troubleshooting/) | when something does not work |
+
+Product pages — [Features](https://claudectl.space/features/) ·
+[Compare](https://docs.claudectl.space/compare/) · [FAQ](https://claudectl.space/faq/) ·
+[Download](https://claudectl.space/download/) ·
+[Changelog](https://claudectl.space/changelog/) — are on
+[claudectl.space](https://claudectl.space/).
+
+## Credits
+
+archeus is built on ideas from the wider Claude Code ecosystem — cognee and Aider's
+repo-map behind the memory graph, Anthropic's `code-review` plugin behind `archeus review`,
+claude-mem behind recent-work memory, OmniRoute behind free execution, and VoltAgent's
+subagent catalog behind the agent library. Every one is credited, with links, on the
+[Credits page](https://docs.claudectl.space/credits/).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

archeus-2.0.0/README.md

@@ -0,0 +1,195 @@
+<h1 align="center">archeus</h1>
+
+<p align="center">
+  <sub><i>Formerly <code>claudectl</code>. Everything migrates on first run —
+  settings, memory graphs and per-project state. Nothing is deleted.</i></sub>
+</p>
+
+<p align="center">
+  <b>The workspace layer for Claude Code.</b><br>
+  Your projects stop being a stream of chats and start being workspaces —
+  with memory, history, and per-project launch control.
+</p>
+
+<p align="center">
+  <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-blue">
+  <img alt="Platform" src="https://img.shields.io/badge/platform-Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-0078D6">
+  <img alt="Dependencies" src="https://img.shields.io/badge/runtime%20deps-zero%20(stdlib)-brightgreen">
+  <img alt="Tests" src="https://img.shields.io/badge/tests-1493-brightgreen">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-green">
+  <img alt="Claude Code" src="https://img.shields.io/badge/for-Claude%20Code-8A5CF6">
+</p>
+
+<p align="center">
+  <b>🌐 <a href="https://claudectl.space">claudectl.space</a>
+  &nbsp;·&nbsp;
+  📖 Full documentation → <a href="https://docs.claudectl.space/">docs.claudectl.space</a></b><br>
+  <sub>Everything below is the short version. Every feature, key binding and file is
+  documented in detail on the docs site.</sub><br>
+  <sub>
+    <a href="https://pypi.org/project/archeus/">PyPI</a> ·
+    <a href="https://claudectl.space/blog">Blog</a> ·
+    <a href="https://claudectl.space/faq">FAQ</a> ·
+    <a href="https://www.linkedin.com/in/muhammad-anas-babar-819647240">LinkedIn</a> ·
+    <a href="https://dev.to/muhammad_anasbabar_31256">dev.to</a>
+  </sub>
+</p>
+
+<p align="center">
+  <sub><i>Not the Rust <code>archeus</code>. Two independent projects share this name;
+  this one is the Python workspace layer for Claude Code.</i></sub>
+</p>
+
+<p align="center">
+  <img alt="archeus dashboard" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-dashboard.png" width="900">
+</p>
+
+---
+
+## What problem does this solve?
+
+Claude Code is excellent inside a session and forgetful between them. Every new
+session starts from nothing, your old sessions are hard to find, and the only
+way to give the agent context is a `CLAUDE.md` that grows until it costs more
+than it's worth.
+
+**archeus sits in front of Claude Code and fixes that.** Pick a project, see
+every session you've ever had in it, and launch with the model, effort,
+permissions and context you meant. Underneath, it maintains a semantic memory
+of the codebase and injects only the part relevant to what you just asked.
+
+It is a terminal UI and a desktop GUI over the same engine — use whichever you
+prefer, they do the same things.
+
+## Quickstart
+
+```bash
+pipx install archeus     # or: pip install archeus
+archeus
+```
+
+There is nothing to build and no dependencies to install. To run it from a
+checkout instead:
+
+```bash
+git clone https://github.com/babarmuhammad/archeus.git
+cd archeus
+python claude-sessions.py          # terminal UI
+python claude-sessions.py --gui    # desktop GUI
+```
+
+Requires **Python 3.10+** and the
+[Claude Code CLI](https://docs.anthropic.com/claude-code) (auto-detected on
+PATH or at `~/.local/bin/`). No API key — it uses the Claude Code auth you
+already have. No third-party packages.
+
+It also ships as a Claude Code plugin, if you'd rather stay inside the session:
+
+```
+/plugin marketplace add babarmuhammad/archeus
+/plugin install archeus@archeus
+```
+
+→ [Full install guide](https://docs.claudectl.space/installation/)
+
+## What it looks like
+
+<table>
+<tr>
+<td width="50%"><img alt="Session browser" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-sessions.png"><br>
+<sub><b>Every session, every project.</b> Search, tag, fork, resume, archive,
+export — across multiple Claude accounts at once.</sub></td>
+<td width="50%"><img alt="Project memory" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-memory.png"><br>
+<sub><b>Memory Claude built about your code.</b> Entities, relations and
+lessons, with the token cost of every block shown before you spend it.</sub></td>
+</tr>
+<tr>
+<td><img alt="Usage" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-usage.png"><br>
+<sub><b>Where the tokens went.</b> Per day, per project, per account, per
+model — read from your own transcripts, not an API.</sub></td>
+<td><img alt="Claude Code's own state" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/gui-claude-code.png"><br>
+<sub><b>Claude Code itself, made visible.</b> Which skills and plugins you
+actually use, what is on disk, and a typed editor for every account's
+settings.</sub></td>
+</tr>
+</table>
+
+The terminal UI is the same tool, keyboard-first:
+
+<p align="center">
+  <img alt="archeus TUI — project picker" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/tui-main.png" width="49%">
+  <img alt="archeus TUI — sessions" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/img/tui-sessions.png" width="49%">
+</p>
+
+<p align="center">
+  <img alt="Architecture graph" src="https://raw.githubusercontent.com/babarmuhammad/archeus/main/docs/graph-real.gif" width="820">
+  <br><sub><b>The architecture graph</b> — every module and its dependencies,
+  expandable down to single files (Python · C/C++ · C# · JS/TS).</sub>
+</p>
+
+<sub>Also: 32 palettes, 8 skins and 4 themed worlds — a skin changes the shape of the app,
+not just its colours.
+<a href="https://docs.claudectl.space/desktop/">See them →</a></sub>
+
+---
+
+## Why archeus
+
+- 🧠 **Intelligent memory, not a memory dump** — task-scoped, token-budgeted injection at the launcher: a micro-index always on (≤250 tok), per-module detail loaded only when Claude touches those files, and an optional per-prompt hook that injects just the subgraph relevant to what you asked.
+- 📚 **It learns from every session** — durable lessons (fixes, decisions, preferences) distilled from transcripts, human-reviewed, injected when relevant, decayed when stale.
+- 🕸️ **See your architecture** — an animated, expandable dependency graph that opens at the project level and drills down to single files.
+- 🩺 **Auto-solves common Claude Code pain** — pre-launch health checks, context-loss insurance after `/compact`, permission-fatigue killer, token-burn advisor, daily usage tracking.
+- 🤖 **Adaptive agents** — the right subagents suggested (or auto-applied) per project from local signals.
+- 📦 **Workspace, not chats** — browse, search, tag, fork, resume and archive every Claude Code session across every project and account.
+- ⚡ **Zero runtime dependencies** — pure Python standard library; uses your existing Claude Code auth.
+
+### How archeus saves tokens
+
+Without archeus, a big project either starves the agent (no context) or floods it (a huge CLAUDE.md loaded every message). archeus spends the *minimum* tokens for the *maximum* relevant context:
+
+- **Flat always-on cost** — the CLAUDE.md block is a ≤250-token index, not a full dump; it does **not** grow as the codebase grows.
+- **On-demand detail** — per-module knowledge lives in path-scoped `.claude/rules/`, so nothing is paid for until it's relevant.
+- **Task-scoped injection** — the optional prompt hook injects only the subgraph your prompt actually needs (budgeted, default ≤600 tok).
+- **No stale weight** — superseded facts are invalidated, dead entities evicted.
+- **Cheaper model for the grunt work** — Plan→Execute runs the expensive model once for the plan and a cheap (or free) one for execution.
+
+→ [How the token economy works](https://docs.claudectl.space/usage/)
+
+---
+
+## Documentation
+
+The full manual lives at **[docs.claudectl.space](https://docs.claudectl.space/)**.
+
+| | |
+|---|---|
+| [Getting started](https://docs.claudectl.space/getting-started/) | what it is, the three surfaces, where to go next |
+| [Installation](https://docs.claudectl.space/installation/) | pipx, pip, checkout, plugin, GUI window, Windows shortcuts |
+| [Quickstart](https://docs.claudectl.space/quickstart/) | install to first session in five minutes |
+| [Command line](https://docs.claudectl.space/cli/) | every command, for scripts and hooks |
+| [Terminal UI](https://docs.claudectl.space/tui/) | every screen and every key binding |
+| [Desktop app](https://docs.claudectl.space/desktop/) | the same workspace as a local app, plus the theme system |
+| [Configuration](https://docs.claudectl.space/configuration/) | every file archeus reads and writes, and where |
+| [Project memory](https://docs.claudectl.space/memory/) | the three injection surfaces, lessons, recall |
+| [Architecture graph](https://docs.claudectl.space/architecture/) | the interactive dependency view |
+| [Usage & cost](https://docs.claudectl.space/usage/) | measuring and cutting the per-turn cost |
+| [API reference](https://docs.claudectl.space/api/) | the local HTTP API the GUI is built on |
+| [Troubleshooting](https://docs.claudectl.space/troubleshooting/) | when something does not work |
+
+Product pages — [Features](https://claudectl.space/features/) ·
+[Compare](https://docs.claudectl.space/compare/) · [FAQ](https://claudectl.space/faq/) ·
+[Download](https://claudectl.space/download/) ·
+[Changelog](https://claudectl.space/changelog/) — are on
+[claudectl.space](https://claudectl.space/).
+
+## Credits
+
+archeus is built on ideas from the wider Claude Code ecosystem — cognee and Aider's
+repo-map behind the memory graph, Anthropic's `code-review` plugin behind `archeus review`,
+claude-mem behind recent-work memory, OmniRoute behind free execution, and VoltAgent's
+subagent catalog behind the agent library. Every one is credited, with links, on the
+[Credits page](https://docs.claudectl.space/credits/).
+
+## License
+
+MIT — see [LICENSE](LICENSE).