volt  by Martian-Engineering

AI coding agent with lossless context management

Created 1 month ago
256 stars

Top 98.5% on SourcePulse

GitHubView on GitHub
Project Summary

Summary Volt is a terminal-based AI coding agent featuring Lossless Context Management (LCM), a deterministic architecture overcoming LLM context window limits. It targets developers and researchers on long-horizon tasks, offering asynchronous compaction, infinite sessions, and reliable memory retrieval, outperforming standard agents on long-context benchmarks.

How It Works Volt's LCM architecture shifts memory management from the LLM to a deterministic, database-backed engine. It uses a dual-state memory: an immutable store for all messages and an active context window. Older messages are asynchronously compacted into summary nodes within a transactional DAG, enabling lossless retrieval without LLM delays or forgetting. This ensures infinite sessions and efficient processing of large data via Operator-Level Recursion tools (LLM-Map, Agentic-Map), delegating iteration to the engine.

Quick Start & Requirements

  • Installation: Use curl -fsSL https://raw.githubusercontent.com/Martian-Engineering/volt/dev/install | bash. Building from source requires Bun 1.3+.
  • Prerequisites: Bun (build), LLM provider API keys (e.g., OpenAI, Anthropic), external Postgres (if embedded unsupported).
  • Configuration: Requires LLM provider/model config (e.g., voltcode.json, .env) and setting VOLTCODE_LCM_MODE (dolt or upward) at startup.
  • Links: Installation script, GitHub repo, OpenCode docs (reference).

Highlighted Details

  • Outperforms Claude Code on OOLONG long-context benchmark up to 1M tokens.
  • Lossless Context Management (LCM) provides asynchronous, non-blocking context compression and deterministic memory.
  • Operator-Level Recursion (LLM-Map, Agentic-Map) enables single tool calls for unbounded inputs via engine-managed iteration.
  • Handles large files externally via stable IDs and precomputed summaries.

Maintenance & Community Volt is a research preview from Voltropy, forked from the permissively licensed OpenCode project. Specific Voltropy community channels or detailed maintenance signals beyond the research preview status are not provided.

Licensing & Compatibility Forked from OpenCode ("permissively licensed"), Volt's specific license is not explicitly stated, creating ambiguity for commercial use or closed-source linking. Verify license.

Limitations & Caveats

  • Research preview status implies potential instability or incomplete features.
  • Compatibility with original OpenCode may vary.
  • upward LCM mode disables off-context retrieval, limiting retroactive search.
  • Embedded Postgres unsupported on some platforms; requires external Postgres.
Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
95 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.