Axiom Unified

Axiom Unified is a free daily local agent specialized in coding and project work. It runs locally on your machine and connects to external AI providers for inference. It is designed as a terminal-first coding companion with safety gates, provider fallback, persistent memory, and 30+ coding-focused tools.

Why Axiom?

• Free-tier focused provider configuration
• Confirmation gates for destructive operations
• Coding-specialized tools for project work
• Persistent memory and project context
• Local runtime with external-provider inference

Quick Start

Install from source

git clone https://github.com/EchoEe247/axiom-unified.git
cd axiom-unified
npm install
npm run build

Install as a global CLI from a local checkout

npm install -g .
axiom "what can you do?"

The npm package is prepared for publication, but this project has not claimed a public npm release until a separate publish receipt exists.

Your first commands

# Analyze your current project
axiom analyze-project

# Run autonomous agent mode with a complex goal
axiom "optimize build process" --auto

# Visualize the Project Knowledge Graph
axiom map

You can also run the built entry point directly:

node dist/index.js "read package.json and suggest updates"

Features

Coding Specialization

• Autonomous agency for complex multi-step goals with --auto
• Project analysis commands such as analyze-project and detect-tech-stack
• Project mapping through the Knowledge Graph
• Code quality tools such as security-scan, complexity, and test-coverage
• Refactoring helpers such as refactor-suggest and bug-predict
• Integration helpers for IDE, CI/CD, and cloud deployment configuration

Safety First

• Confirmation gates for file writes, shell commands, and git operations
• Provider limits, free-tier monitoring, and fallback routing
• Context-aware memory with privacy controls
• Granular tool permission classification

Intelligent Systems

• Persistent memory across sessions
• Knowledge Graph entity and relationship tracking
• Provider fallback across Groq, Cerebras, NVIDIA, and Mistral
• Autonomous planner, executor, and experience learner components

Performance

• Terminal-first runtime
• Optional daemon mode with axiom serve
• Fast local startup
• Minimal production dependencies

Documentation

• Getting Started
• Operating Guide
• Provider Setup
• Safety Model
• Release Readiness

Architecture

src/
|-- core/           # Core systems: memory, knowledge graph, context
|-- runtime/        # Runtime systems: loop, dispatcher, planner
|-- tools/          # Tool implementations
|-- daemon/         # Daemon/client architecture
|-- persistence/    # Session storage
`-- providers.ts    # Multi-provider client

Development

Prerequisites

• Node.js 18+
• npm 8+

Development commands

npm install          # Install dependencies
npm run check        # TypeScript compilation check
npm test             # Run test suite
npm run build        # Build project
npm run serve        # Start daemon mode

Release-readiness commands

npm run verify:offline
npm pack --dry-run

prepack runs the production build before package creation. prepublishOnly runs the full offline verification gate before any real npm publish attempt.

Adding New Tools

1. Add the tool implementation in src/tools/.
2. Register the tool in the registry.
3. Add appropriate safety gates.
4. Add focused tests.
5. Update documentation.

Contributing

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• CHANGELOG.md

License

MIT License. See LICENSE for details.