Skip to content

Axonel v0.1.0

Choose a tag to compare

View all tags
@roonakyadav roonakyadav released this 19 Sep 10:51
· 57 commits to main since this release
v0.1.0
b162363

Axonel v0.1.0 — First Public Release

Axonel is a local-first autonomous engineering supervisor daemon designed to supervise external CLI coding agents (such as Google Gemini CLI) in isolated Git worktrees with out-of-band test verification and explicit human acceptance gates.

This is the first public release of Axonel (v0.1.0).

Key Capabilities & Guarantees

  • Isolated Git Worktree Execution: Executes tasks in dedicated Git worktrees (.plexis/worktrees/<task_id>), guaranteeing that your active workspace and branch remain untouched during background execution.
  • Independent Physical Verification: Rejects LLM self-reports of success. Axonel executes actual test toolchains (cargo test, npm test, pytest) out-of-band directly on the filesystem and requires a clean Git tree (working_tree_clean == true) and real Git commit before considering any deliverable.
  • Explicit Human Acceptance Gate: Autonomous execution strictly halts at AwaitingAcceptance. Direct unaccepted integration attempts return HTTP 409 Conflict. Code cannot reach your target branch without explicit human review and acceptance.
  • Structured Review Packages: Inspect complete deliverables via GET /api/v1/missions/{id}/review and the Web UI, including unified git diffs, changed files lists, verification logs, and HEAD freshness indicators.
  • Transactional Git Integration & Crash Recovery: Atomic Git merge execution with automatic rollback on merge conflict (git merge --abort). Startup reconciler uses Git ancestry (git merge-base --is-ancestor) to durably recover from abrupt SIGKILL or crashes without false reporting.
  • Autonomous Multi-Cycle Replanning: Automatically detects stagnation, failed tests, and compilation errors, driving bounded recovery attempts with structured error feedback.

Certified Platform & Proven Agent Integrations

  • Certified Supported Platform: Linux x86_64 (x86_64-unknown-linux-gnu). Build-tested, quality-gated, and verified in continuous integration.
  • Proven External Agent Backend: Google Gemini CLI v0.60.0 (gemini_cli). This is the only external agent integration currently proven end-to-end for production coding missions in v0.1.0. (Requires local authentication via gemini auth login or GEMINI_API_KEY).
  • Internal Test Provider: Deterministic local mock agent (fake_agent) used for automated regression test suites and CI.
  • Scaffold Stubs: Anthropic Claude Code (claude_code), OpenAI Codex (codex), and OpenCode (opencode) are registered interface stubs under development and are not certified for production execution in v0.1.0.

Security Model Defaults

  • Strict Loopback Default: The server binds strictly to 127.0.0.1:3000 by default.
  • Mandatory Authentication for External Binds: Binding to 0.0.0.0 or external network interfaces requires --auth-token or AXONEL_AUTH_TOKEN; startup fails immediately with exit code 1 if unauthenticated.
  • Automated Secret Redaction: Automated in-memory regex sanitization scrubs Bearer tokens, OpenAI/Anthropic API keys (sk-...), Google API keys (AIza...), and GitHub access tokens (ghp_...) from terminal buffers, logs, and events.
  • Path Confinement: Rejects directory traversal (..) attempts outside registered workspace boundaries.

Known Operational Boundaries & Limitations

As documented in docs/V1_LIMITATIONS.md:

  • Single-Repository Scope: Confined to single Git repositories; multi-repository coordination is not supported in v0.1.0.
  • Hardware Architecture Scope: Certified strictly on Linux x86_64. Linux aarch64 is architecturally supported but unverified on physical hardware. macOS is experimental; Windows is unsupported due to POSIX process-group containment requirements (setpgid/killpg).
  • Disk Footprint for Worktrees: Each concurrent mission provisions a separate Git worktree. Repositories with large untracked build artifacts (target/, node_modules/) require sufficient disk space.
  • No Automatic Merge Conflict Resolution: If target branch HEAD moves concurrently and causes a merge conflict, Axonel rolls back cleanly and returns HTTP 409 Conflict. Manual resolution is required.
  • No Distributed Execution: Axonel v0.1.0 operates as a single-node workstation daemon; cluster or distributed execution is out of scope.
  • Test Suite Ground Truth: Verification guarantees that your configured test commands ran and passed on disk; it does not prove correctness beyond the test suite's coverage.

Installation & First Run

From source on Linux x86_64:

# Clone the repository
git clone https://github.com/axonel/axonel.git
cd axonel

# Build the Web Dashboard SPA
cd web && npm ci && npm run build && cd ..

# Compile the release binary
cargo build --release -p plexis-server --bin axonel

# Start the Axonel supervisor daemon on loopback
./target/release/axonel server --host 127.0.0.1 --port 3000

Access the Web Dashboard at: http://127.0.0.1:3000

Assets 2
Loading