🦀 AURACRAB

The Autonomous Digital Butler for the Agentic Era.
Persistent. Proactive. Powerful.

Important

Auracrab is a core component of the vibeauracle Go CLI ecosystem. It leverages vibeauracle's advanced intelligence layer for repository-wide analysis, Copilot SDK planning, and multi-agent coordination. Note: vibeauracle is automatically installed and managed as a dependency during the Auracrab installation/update process.

---

📺 The Interface

Auracrab features a stunning, high-fidelity TUI built with Charm Bracelet tools. Monitor your tasks, check system vibes, and manage your Crabs in real-time.

🦀 AURACRAB  v1.0.0 - AGENTIC DAEMON

DELEGATED TASKS                 SYSTEM VIBES
-----------------------         -----------------------
⏳ task_1706352000              Health: Excellent
   Security audit...            Status: 1 active, 12 done

✅ task_1706351000              LOADED SKILLS
   Update dependencies...       • browser
                                • social
❌ task_1706350000              • autocommit
   Deploy to prod...            • system

[↑/↓] Navigate • [r] Refresh • [q] Quit • [v] View Output

🌊 The Vision

Auracrab is not just another CLI tool. It is an autonomous, persistent AI agent daemon built in Go, designed to act as your proactive "Digital Butler." It lives in your system, watches your vibes, and executes complex multi-step tasks while you sleep.

Whether it's auditing your security, managing your social presence, or self-healing your development environment, Auracrab handles it with Thought Signatures—maintaining deep context across sessions.

✨ Core Pillars

🧠 Memory	🐙 Orchestration	🛡️ Security
Long-term vector storage for permanent context retrieval.	Multi-agent coordination via Copilot SDK & AgentKit.	Go-native sandboxing with system-level isolation.

🛠️ Key Features

🦀 Specialized Crabs

Register user-defined agents with custom instructions and specialized skillsets.

📡 Messaging-First

Control your butler via Telegram or Discord. Send a task on the go, and Auracrab handles the rest.

🩺 Live Health Monitoring

Real-time analysis of system logs and automated "doctor" recovery using Gemini Multimodal Live API.

🧩 MCP Native

Full support for the Model Context Protocol to bridge agents with local and cloud-based tools.

⚡ Vibe Mode

Direct integration with vibeauracle for high-fidelity intelligence and thought signatures.

🚀 Getting Started

Installation

Via anyisland (Fastest):

anyisland install nathfavour/auracrab

Via Shell:

curl -sSL https://raw.githubusercontent.com/nathfavour/auracrab/main/install.sh | bash

Via Go:

go install github.com/nathfavour/auracrab/cmd/auracrab@latest

Build from Source:

git clone https://github.com/nathfavour/auracrab.git
cd auracrab
make build

Quick Commands

Command	Action
auracrab start	Spin up the butler daemon
auracrab vibe	Enter the interactive TUI
auracrab crab list	View your specialized agents
auracrab vault set	Securely store API secrets

🏗️ Architecture

graph TD
    User((User)) -->|Telegram/Discord| Butler[Butler Daemon]
    User -->|CLI/TUI| Butler
    Butler -->|Orchestrates| Crabs[Specialized Crabs]
    Butler -->|Memory| VectorDB[(Vector Memory)]
    Butler -->|Security| Sandbox{Sandbox}
    Crabs -->|Execute| Skills[Skill Registry]
    Skills -->|MCP| Tools[Local/Cloud Tools]
    Sandbox -.->|Isolation| Skills

Loading

Auracrab follows a modular, plugin-based architecture:

• Agent Engine: Orchestrates hybrid model strategies.
• Connector Registry: Centralized hub for SaaS and messaging integrations.
• Skill Registry: Extensible toolsets (Browser, Social, Auto-Commit, etc.).
• Vault: Secure storage for sensitive API keys and credentials.

Tip

Check out ARCHITECTURE.md for a deep dive into the internals.

---

Built with ❤️ by Nath Favour and the Auracrab Community.
"Stay crabby, stay productive."