@arcforge/axon 0.0.2 → 0.0.3

package/README.md

@@ -0,0 +1,195 @@
+# Axon
+
+> **A new generation of agentic intelligence.**
+
+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.
+
+```bash
+npm install -g @arcforge/axon
+```
+
+**Built different. Think different.**
+
+---
+
+## What Makes Axon Different?
+
+### Designed Cognition, Not Prompted Behavior
+
+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.
+
+This isn't prompted behavior. It's **designed cognition**.
+
+### Persistent Memory Architecture
+
+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.
+
+- **No tokens wasted** on redundant context
+- **No scanning or searching** — it simply remembers
+- **Evolving understanding** that improves as you work together
+
+### Network Intelligence
+
+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
+
+All working together as a single, cohesive intelligence runtime.
+
+### No Slop, Just Code
+
+Axon understands your architecture, follows your patterns, and writes thoughtful solutions. No unnecessary abstractions, no premature optimizations, no junior-level mistakes.
+
+It thinks like a senior engineer because it's **designed to think**, not just pattern-match.
+
+---
+
+## 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.
+
+### 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
+
+```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
+```
+
+---
+
+## How It Works
+
+### 1. **Initialize** — Build a Semantic Map
+
+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.
+
+### 2. **Instruct** — Context Without Friction
+
+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
+
+Manage your subscription at [axon.arclabs.it/billing](https://axon.arclabs.it/billing)
+
+---
+
+## Support
+
+- **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)
+
+---
+
+## License
+
+Copyright © 2025 ArcForge. All rights reserved.
+
+This is proprietary software. See [LICENSE](./LICENSE) for details.
+
+---
+
+**Built different. Think different.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforge/axon",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
     "bun": ">=1.0.0"
   },
   "files": [
-    "index.js"
+    "index.js",
+    "README.md"
   ]
 }