Skip to main content

Turn a coding-AI chat session into a deployable, continuously-learning SME agent served over MCP.

Project description

scion

Turn a coding-AI chat session (Claude Code or Codex CLI) into a deployable, continuously-learning subject-matter-expert agent that any MCP-aware host can talk to.

scion extracts everything from a Claude Code or Codex CLI session — every message, every tool call, every memory file, every skill, every config — distills it into a portable, git-committable Agent Bundle, and serves the bundle as a stdio MCP server. Your colleague's Claude Code or Codex CLI calls /mcp__scion-<name>__ask (or the query tool) and gets a grounded answer. The bundle learns from every interaction via a nightly dream loop that consolidates new episodes into memory, gated by an evaluation ratchet so the agent cannot silently degrade.

Status

Pre-alpha. Building toward v0.1.0 (Phases 1–4 of the PRD).

Phase What State
0 Foundation, governance, context docs in progress
1 Claude Code extractor + bundle + CLI + LLMClient skeleton planned
2 Stdio FastMCP server + distill + memory tool wiring planned
3 Episode writeback + nightly dream loop with eval ratchet planned
4 Codex CLI extractor (closes v0.1.0) planned

Three-command quickstart (target — not yet runnable)

uv tool install scion
scion init demo
scion demo                  # full pipeline against synthetic fixture, no API key

Once Phase 1 ships, replace the third line with:

scion extract claude-code --cwd ~/proj/recon --output ./bundles/recon-sme
scion install claude-code ./bundles/recon-sme
# Restart Claude Code → /mcp__scion-recon-sme__ask "how do partial refunds work?"

How it compares

scion mem0 Letta / MemGPT Zep CE
Local-first, no daemon hosted daemon needs Neo4j
Git-committable bundles
Continuous learning loop eval ratchet (Karpathy) LLM-extracted facts tiered memory (managed) temporal graph
Memory shape files (markdown) facts (KV+vector) tiered store knowledge graph
Provider portability LiteLLM (any) OpenAI-default OpenAI-default provider-agnostic
Plugin extractor surface n/a n/a n/a
Source-tool side effects none (read-only) n/a n/a n/a

Supported on

Linux + macOS, Python 3.11/3.12/3.13. Windows is out of scope for v0.1.0.

License

Apache-2.0.

Contributing

See CONTRIBUTING.md. DCO sign-off required (git commit -s); a hook is provided.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scion-0.1.0.tar.gz (130.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scion-0.1.0-py3-none-any.whl (94.1 kB view details)

Uploaded Python 3

File details

Details for the file scion-0.1.0.tar.gz.

File metadata

  • Download URL: scion-0.1.0.tar.gz
  • Upload date:
  • Size: 130.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for scion-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c627b6e98d304edf5dfc1c3d3fb01ec653694fe5e276b7b0eb1c745b36c90da1
MD5 d5bbc5170c04845e008bd9cbb72e2609
BLAKE2b-256 e0677bdc661ff651d0162c358f6fbb47a918e10b4b95b382e5b63b6b5b5080ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for scion-0.1.0.tar.gz:

Publisher: publish.yml on Tejas7/scion

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scion-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: scion-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 94.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for scion-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7f7ab4c4fadcb2f4087ef73b1b06cbf943a6904f03612525c24138b1c49f510e
MD5 5af5e12c1673e27a41c3781c1f4e6d33
BLAKE2b-256 d5cfcbbe1d38485c08c2c366335c689d432a4b91e092b67131072a9e6e08d11a

See more details on using hashes here.

Provenance

The following attestation bundles were made for scion-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Tejas7/scion

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page