@arcforge/axon 1.0.4 → 1.0.6

package/README.md

@@ -1,195 +1,105 @@
 # Axon
 
-> **A new generation of agentic intelligence.**
+A clean, fast coding agent with modular capabilities.
 
-Axon isn't another chatbot with tools. It's a **cognitive operating system** — a distributed network of specialized AI subsystems that coordinate like a real mind to understand, reason, and code alongside you.
+Axon is a terminal-first coding agent built for developers who want something simple, powerful, and extensible without fighting the tool.
 
 ```bash
 npm install -g @arcforge/axon
 ```
 
-**Built different. Think different.**
+## Why Axon
 
----
+Most coding agents are either rigid with fixed tools and behaviour, or messy and hard to extend.
 
-## What Makes Axon Different?
+Axon takes a different approach.
 
-### Designed Cognition, Not Prompted Behavior
+### Modular by default
 
-Axon runs on a proprietary **cognitive operating system** that orchestrates dozens of AI models as a single, coherent intelligence. Modular in structure, composable in function, transparent in reasoning.
+Axon runs inside a capsule environment where capabilities can be added dynamically.
 
-This isn't prompted behavior. It's **designed cognition**.
+* Install tools on demand
+* Extend the agent with simple TypeScript modules
+* No complex setup or configuration
 
-### Persistent Memory Architecture
+The agent is not limited to what it started with.
 
-Most agents drown in their own context windows, rereading your project on every turn. Axon forms a **persistent semantic map** of your codebase — architecture, patterns, conventions, dependencies — and recalls only what's relevant in the moment.
+### Fast, clean terminal UX
 
-- **No tokens wasted** on redundant context
-- **No scanning or searching** — it simply remembers
-- **Evolving understanding** that improves as you work together
+Built on a custom terminal renderer.
 
-### Network Intelligence
+* Instant startup
+* Smooth streaming output
+* Clean diffs, logs, and process views
+* Keyboard-first navigation
 
-A distributed network of specialized subsystems coordinate seamlessly:
-- **Planners** design implementation strategies
-- **Coders** write clean, contextual solutions
-- **Critics** review for quality and correctness
-- **Test Writers** ensure robustness
+It behaves like a real development tool.
 
-All working together as a single, cohesive intelligence runtime.
+### Works with real models
 
-### No Slop, Just Code
+Use the models you already have.
 
-Axon understands your architecture, follows your patterns, and writes thoughtful solutions. No unnecessary abstractions, no premature optimizations, no junior-level mistakes.
+* OpenAI
+* Anthropic
+* OpenRouter
 
-It thinks like a senior engineer because it's **designed to think**, not just pattern-match.
+Bring your own API keys and start immediately.
 
----
+### Built for real work
+
+Axon supports:
+
+* File reads and writes
+* Subprocess execution
+* Tool usage
+* Multi-step coding tasks
+
+It focuses on being a solid, usable coding agent.
 
 ## Quick Start
 
 ```bash
-# Install globally
 npm install -g @arcforge/axon
-
-# Launch the terminal UI
 axon
 ```
 
-**Requirements:**
-- [Bun](https://bun.sh) runtime installed
-- Valid Axon API key (get yours at [axon.arclabs.it](https://axon.arclabs.it))
-
----
-
-## Features
-
-### Beautiful Terminal UI
-Built with Blessed for a responsive, full-featured text user interface. Navigate with keyboard shortcuts, manage multiple workspaces, and visualize agent reasoning in real-time.
-
-### Network Intelligence
-Multiple specialized AI subsystems coordinating as a single mind — planners, critics, coders, test writers — all working in parallel across intelligent inference pipelines.
-
-### Process Management
-Monitor and control running processes, track execution state, and visualize the cognitive control loop in action.
-
-### Kanban-Style Task Management
-Built-in task board for organizing work, tracking agent decisions, and managing multi-step implementations.
-
-### Device Authentication
-Secure device flow authentication connects your CLI to your Axon account seamlessly.
+Then add your API key and start prompting.
 
-### Real-Time Visualizations
-Audio visualizer, system metrics, and cognitive state monitoring — see your agent think.
-
----
-
-## Usage
-
-Once launched, navigate with:
-
-- **Arrow keys** → Navigate menus and panels
-- **Enter** → Select / Execute
-- **Esc** → Go back
-- **Tab** → Switch between panels
-- **/help** → View all commands
-
-### Example Session
+## Example
 
 ```bash
-$ axon
-
-# Initialize context for your project
-> axon init
-
-# Ask questions about your codebase
-> "Why was this module created?"
-> "What depends on this function?"
-
-# Request implementations
-> "Add user authentication with JWT"
-
-# The agent plans, codes, tests, and explains its reasoning
+> Add a CLI command to export this data as JSON
+> Refactor this module to remove duplication
+> Run the test suite and fix failures
 ```
 
----
-
-## How It Works
-
-### 1. **Initialize** — Build a Semantic Map
+Axon will plan the task, edit files, run commands, and show diffs and output in real time.
 
-As Axon explores your codebase, it forms a persistent map of how everything fits together. Not files. Not tokens. But **meaning**: purpose, relationships, design intent.
+## Extending Axon
 
-### 2. **Instruct** — Context Without Friction
+You can add your own tools with a simple module.
 
-Ask questions like a senior engineer would:
-- "Why was this module created?"
-- "What depends on this function?"
-- "How did this system evolve over time?"
-
-Axon answers immediately — without scanning, searching, or invoking tools. It simply **remembers**.
-
-### 3. **Execute** — Distributed Intelligence
-
-Complex tasks are routed across parallel inference pipelines. Heavy reasoning goes deep with advanced models. Simple tasks stay lean and fast.
-
-A purpose-built cognitive architecture that makes traditional LLM tools feel like they're standing still.
-
----
-
-## Architecture
-
-Axon is powered by:
-
-- **Cognitive Operating System** — Proprietary runtime for orchestrating distributed AI subsystems
-- **Persistent Memory Layer** — Semantic graph storage with contextual retrieval
-- **Parallel Inference Pipelines** — Intelligent task routing across model tiers
-- **Real-Time State Monitoring** — Observable cognitive control loop
-
-Built on [Cognos](https://cognos.dev) — a first-class cognitive framework for agentic intelligence.
-
----
-
-## Authentication
-
-Axon uses **device flow authentication** to securely connect your CLI to your account:
-
-1. Run `axon` for the first time
-2. Visit the authentication URL shown in the terminal
-3. Approve the device from your browser
-4. Start coding
-
-Your API key is stored securely and refreshed automatically.
-
----
-
-## Credits & Billing
-
-Axon operates on a **credit-based system**:
-
-- **1,000 credits per £1**
-- **Subscription plans** grant monthly credit allocations
-- **Top-ups** available for one-time purchases
-- Credits never expire
+```ts
+export default defineModule({
+  name: "dice",
+  tools: {
+    roll: () => Math.floor(Math.random() * 6) + 1
+  }
+})
+```
 
-Manage your subscription at [axon.arclabs.it/billing](https://axon.arclabs.it/billing)
+Reload the environment and the agent can use it.
 
----
+## Status
 
-## Support
+Axon is in early beta.
 
-- **Website**: [axon.arclabs.it](https://axon.arclabs.it)
-- **Documentation**: [axon.arclabs.it/docs](https://axon.arclabs.it/docs)
-- **Billing**: [axon.arclabs.it/billing](https://axon.arclabs.it/billing)
+* Core system is stable
+* UX is polished
+* Capabilities are still expanding
 
----
+Looking for a small group of developers to try it and give feedback.
 
 ## License
 
-Copyright © 2025 ArcForge. All rights reserved.
-
-This is proprietary software. See [LICENSE](./LICENSE) for details.
-
----
-
-**Built different. Think different.**
+Proprietary. © ArcForge