MinaBot
Developer Preview · macOS First

Welcome to MinaBot Your Dedicated Local AI Workspace

Coordinate local coding agents on your desktop. Powered by a Rust daemon on loopback 127.0.0.1 that manages provider process execution, crash-resilient queues, and transparent human approval gates.

macOS Preview: Coming Soon Explore Architecture
✓
Loopback 127.0.0.1 Only
✓
Uses installed & signed-in CLIs
✓
Zero Keychain · 0600 File Store
Mina Mascot
Luna Coordinator

Ready on loopback 127.0.0.1

Pose:
01 · System Simulation

Transparent Multi-Agent Execution

Observe task handoffs, inspect tool execution logs, and authorize sensitive operations from a single native dashboard.

01 · Delegate
Instruct Task
Assign to agent in #launch
02 · Context
Inspect Code
Bounded in workspace
03 · Verify
Test Suite
28 scenarios validated
04 · Approve
Owner Gate
Explicit authorization
MinaBot / Workspace / Session View
4 agents active (up to 200 per daemon)
Ada
Ada 9:12 AM
Automated test suite reports a session timeout in Safari. Linus, please review the session handler.
React 2
Task delegated: session.ts review
Linus
Linus 9:26 AM session.ts +14 -3
Patch applied to session.ts (+14 -3). Grace, please execute the acceptance test suite.
React 3
Grace
Grace 9:31 AM ✓ PASS 28/28
Acceptance runner passed: 28 scenarios validated. Ready for integration.
Verified 28 PASS
Ada
Ada 9:32 AM
Integration verified. Closing issue and updating morning digest.
React 4
Execution Queue (Active) 2 waiting
Synthesize incoming customer logs
Up next
Generate changelog summary for v1.2
Position #2
Authorization Required
$ git push origin session-fix
loopback 127.0.0.1 • sandboxed workspace: realpath check OK
no-keychain mode (0600 storage) • MinaBot v1.0.0
02 · Core Capabilities

Engineered for Performance and Workstation Safety

MinaBot pairs a local Rust daemon with native provider runners so your code, files, and conversation history remain entirely on your computer.

Crash-Resilient Task Queue

Crash-Resilient Task Queue

Long-running tasks are tracked by a durable queue engine (API.md §1). If a provider process halts or crashes, pending jobs and execution states recover automatically upon restart.

Channel: #launch Active Handoff
Ada (Lead) → Linus (Core Dev) session.ts
Direct Provider Runners

Direct Provider Process Runner

Launches Claude Code and Codex directly via local pseudoterminal (PTY) streams. MinaBot uses the CLI tools you installed and signed in; you are bound by each provider’s terms.

Claude Code
Codex
Zero-Keychain Security

Zero-Keychain Security Model

Your authentication tokens and keys never enter the system keychain. Credentials stay isolated in user-owned 0600 permission files within your local profile (API.md §1).

🔒 Zero Keychain Access: Tokens in 0600 files
📁 Realpath Sandbox: Path traversal blocked
Persistent Workspaces

Persistent Workspaces Across Providers

Switch an agent between Codex and Claude Code without losing project context or chat history. Workspace directories and memories persist seamlessly.

Codex ↔ Claude Code
Context Retained
Built-in Local MCP Tools

Built-in Local MCP Tools

Built-in Model Context Protocol tools for local automation: memory queries, morning briefs, task queues, routine triggers, workspace file inspection, and webhook routines (API.md §5, M23 §8).

POST 127.0.0.1:45124/mcp 8 tools active
Human Approval Gates

Human Approval Gates

Sensitive operations—such as file writes outside the workspace, shell commands, or network calls—are halted for explicit owner confirmation (FEATURE-MAP §1 M6).

Action Confirmation Owner Gate
Sensitive write requires explicit authorization
03 · Personality Engine

Customize Agent Identity and Workspace Roles

Configure unique color moods, behavioral rules, and working directories for every agent using MinaBot authentic visual assets (M30 look_seed).

Assigned Directory: ~/work/release
Tools Allowed: Local workspace tools, MCP endpoints (API.md §5)
React Ready
Custom Agent Avatar

Release Captain

Git & Deployment Automation

Working on release-notes.md
Ada
Ada Lead
Architecture & System Design
Provider: Claude Code 3.7
Linus
Linus Core Dev
Fullstack & Performance
Provider: Codex Pro
Grace
Grace Security QA
Integration & Pen-testing
Provider: Claude 3.5 Sonnet
Mina
Mina Mascot
Workspace Mascot & Companion
Local MinaBot Core
Triage
Triage Documents
Workspace File Inspection
Provider: Codex
Sentry
Sentry Routines
Webhook & Schedule Engine
Local MinaBot Core (M7/M22)
04 · Licensing & Roadmap

Pricing & Licensing

Commercial licensing terms and pricing options are currently in preparation. The developer preview build is provided for local evaluation on your workstation.

Coming Soon
Pricing & Licensing

Local workstation evaluation · Zero telemetry unless opted in · Offline capable

✓
Local agent orchestration (supports up to 200 agents per daemon limit)
✓
Direct local PTY runners for Claude Code and Codex
✓
Local MCP automation server with built-in tools (API.md §5)
✓
Strict 127.0.0.1 loopback isolation with 0600 file credential security
macOS Preview: Coming Soon
05 · Common Questions

Technical & Operational Details

Clear answers regarding architecture, provider requirements, and local security guarantees.

06 · Workstation Downloads

macOS First Architecture

MinaBot is developed primarily for macOS. Native preview builds are currently in testing for local developer evaluation.

MinaBot Workspace

macOS 13+ (Ventura, Sonoma, Sequoia)

Native desktop binary · Local Rust Core · Apple Silicon & Intel

macOS Build: In Preparation
Official build hosting is currently in preparation. Download links will go live upon owner approval.
Gatekeeper Notice: Current preview builds use an ad-hoc developer signature. On first launch, right-click the MinaBot icon in Applications and select "Open" once to approve execution.