🚀 Quick Start · ⚡ Features · 📖 Usage · 🧠 Architecture · 🗺️ Roadmap

🔥 Why Dardcor Agent?

Most AI assistants are glorified chatbots — they advise, suggest, and then leave you to do all the actual work.

Dardcor Agent is different. It executes.

It doesn't wait for your next prompt. It analyzes your system, makes decisions, runs code, detects errors, fixes itself — and keeps going. This is what true AI autonomy looks like: a relentless local agent that turns your intent into results with zero hand-holding.

Whether you're a solo developer, a power user, or someone who's sick of switching between 10 tools — Dardcor Agent collapses your workflow into a single, razor-sharp command.

| Capability | Ordinary AI Chat | Dardcor Agent | |:---|:---:|:---:| | Answer questions | ✅ | ✅ | | Autonomous code execution | ❌ | ✅ | | Self-healing on errors | ❌ | ✅ | | 100% local & private | ❌ | ✅ | | Web UI + CLI in one tool | ❌ | ✅ | | Ultra token-efficient output | ❌ | ✅ | | Zero external data exposure | ❌ | ✅ |

✨ Features

🔥 Ultra Token Efficient

Every token counts. Dardcor Agent's prompt architecture is engineered to extract maximum logical output with minimum token usage — leaner responses, faster results, lower cost. No fluff, no filler, just pure execution.

🤖 Fully Autonomous Execution

This isn't an assistant that drafts code for you to copy-paste. Dardcor Agent analyzes, decides, and executes operations directly on your local system — end-to-end, without babysitting.

🛠️ Self-Healing System (Doctor Mode)

Broken config? Corrupted dependencies? Just run dardcor doctor and watch the agent diagnose, repair, and restore your system to peak condition — automatically, no manual debugging required.

🔒 100% Local & Private

Every operation stays within 127.0.0.1:25000. Zero telemetry. Zero external calls. Your code, your secrets, your data — never leave your machine. Privacy isn't a feature here, it's the architecture.

🌐 Modern Web UI — Real-Time Dashboard

A sleek, interactive browser dashboard with live session history, real-time feedback, and a built-in cache-busting system. Beautiful and functional — no Electron bloat, just open http://127.0.0.1:25000.

⚡ Lightweight CLI — Terminal Native

A blazing-fast terminal interface with zero overhead. Perfect for automation pipelines, scripting, and developer workflows that demand speed over spectacle.

🚀 Quick Start

Prerequisite: Node.js must be installed. Use a terminal with admin access if required.

Install via NPM (Recommended)

npm install -g dardcor-agent

Once installed, the dardcor command is immediately available globally. A local JSON-based database is initialized automatically on first run — no setup, no configuration wizard, no friction.

Install from Source

git clone https://github.com/Dardcor/Dardcor-Agent.git
cd Dardcor-Agent

Update

# Via NPM
npm install -g dardcor-agent@latest

# Via GitHub (bleeding edge)
npm install -g github:Dardcor/Dardcor-Agent

Uninstall

npm uninstall -g dardcor-agent

📖 Usage

Show All Commands

dardcor help

🌐 Launch Web UI

dardcor run

Open your browser and navigate to:

http://127.0.0.1:25000

What you get in Web UI:

• Real-time session dashboard
• Interactive conversation history
• Built-in cache-busting system
• Clean, responsive interface — no install, no app, just a browser tab

💻 Launch CLI Mode

dardcor cli

Built for:

• Rapid coding sessions directly in terminal
• Automation, CI pipelines, and scripting
• Lightweight workflows where UI overhead is unwelcome

🛠️ Run System Doctor

dardcor doctor

Trigger this whenever something breaks. The agent will:

1. Scan — detect broken configurations and failed dependencies
2. Diagnose — identify the root cause, not just symptoms
3. Repair — automatically restore the system to its optimal state

No error Googling. No Stack Overflow rabbit holes. Just one command.

🧠 System Architecture

Dardcor Agent
├── 🌐 Web Server (Go backend)      → 127.0.0.1:25000
├── 💻 CLI Interface (Node.js)      → Direct terminal access
├── 🗄️  Local Database              → /database (JSON file-based)
├── ⚙️  Config Store                → ~/.dardcor/config.json
└── 🔒 Network Scope               → Localhost only — zero external exposure

Tech Stack:

| Layer | Technology | Why It's Here | |:---|:---|:---| | Backend | Go | Native concurrency, high throughput, tiny binary | | Frontend | TypeScript + Vite | Type-safe, fast-build, modern DX | | CLI | Node.js | Cross-platform, lightweight, instant startup | | Storage | JSON File-based | No database server required — just works |

The architecture is intentionally simple. No microservices. No Docker requirement. No ops overhead. A single agent that runs anywhere Node.js runs.

🗺️ Roadmap

• [x] Web UI with real-time dashboard
• [x] CLI mode
• [x] Self-healing system (dardcor doctor)
• [x] Local-only network (privacy-first by default)
• [ ] Multi-agent collaboration system
• [ ] Plugin ecosystem & extension API
• [ ] Cloud sync (optional, privacy-first)
• [ ] GUI config editor (no more JSON editing)

📄 License

Licensed under the MIT License — free to use, modify, and distribute.

Built with 💜 by Dardcor

If this project saves you time, a ⭐ means everything.