Back to rankings

crshdn/mission-control

TypeScriptautensa.com

The world's first Autonomous Product Engine (APE): AI agents research your market, generate features, and ship code as PRs. Convoy mode, crash recovery, cost tracking, 80+ API endpoints. Self-hosted via OpenClaw Gateway.

aiagentautomationopenclaw
Star Growth
Stars
2.1k
Forks
438
Weekly Growth
โ€”
Issues
9
1k2k
Jan 26Mar 26May 26Jul 26
Artifactsnpmnpm install mission-control
README

Autensa

The World's First Autonomous Product Engine
autensa.com

Your products improve themselves โ€” 24/7 โ€” while you sleep.
Research โ†’ Ideation โ†’ Swipe โ†’ Build โ†’ Test โ†’ Review โ†’ Pull Request โ€” fully automated.

I highly recommend getting Hetzner VPS to run this. You can sign up here.

GitHub Stars GitHub Issues License PRs Welcome Next.js TypeScript SQLite

๐ŸŽฎ Live Demo โ€ข Quick Start โ€ข Docker โ€ข What's New โ€ข Features โ€ข How It Works โ€ข Configuration โ€ข Contributors

โ–ถ๏ธ Watch the Autensa v2 Introduction


๐Ÿš€ What's New in v2.5.1

Repo Setup & PR Recovery

Autopilot now has a product-level Repo Setup tab that verifies a repository is ready before agents create PR-bound work. It checks authenticated git access, default branch confirmation, GitHub API and PR metadata access, GitHub Actions status, workflow token permissions, PR workflow secrets, and PR workflow variables.

When setup is blocked, users can fix supported GitHub configuration from the UI: set workflow token permissions to read/write, add missing Actions secrets, and add missing Actions variables. Secret values are written directly to GitHub and are not stored in Autensa.

Build Queue tasks with GitHub PRs now include a PR checks recovery panel. Failed checks are classified as retryable, repo setup, or external provider failures, with actions to rerun failed GitHub Actions jobs or rerequest external checks where GitHub supports it.

Private Repo Readiness

Product creation and settings now validate private repos with authenticated git access, detect the remote default branch, and require user confirmation before Autopilot starts. Workspace isolation preflights the selected branch and can use the detected default branch, avoiding main clone failures on repos that use master.

Previous Releases

v2.5.0 โ€” Dispatch & Product Settings Fixes

Per-Task Agent Sessions (#99)

Each dispatched task now gets its own OpenClaw conversation session. Previously, all tasks assigned to the same agent shared one session, causing context to accumulate across tasks until the model's context window was exhausted and the agent stalled. The openclaw_sessions table already had a task_id column โ€” dispatch now uses it for session lookup, session ID generation, and insert. Parallel tasks on the same agent work independently.

Flexible Agent ID Validation (#100)

Agent ID fields now accept both standard UUID format (8-4-4-4-12) and 32-character hex identifiers from the OpenClaw gateway. Previously, Zod's strict .uuid() validation rejected gateway-format agent IDs, causing "Invalid UUID" errors when assigning imported agents to tasks.

Task Delete Button Fix (#111)

The task delete button now shows a loading state ("Deleting..."), disables during the request, and displays inline error messages when deletion fails. Previously, the button had no feedback โ€” if the API request failed or was slow, users saw no response and assumed the button was broken.

Product Pause & Archive (#98)

The Autopilot product settings modal now includes a Status dropdown (Active / Paused) and a Danger Zone section with an Archive button. Paused products stop automated research and ideation cycles. Archived products are hidden from the dashboard but data is preserved. The main product listing now filters out archived products.

v2.4.1 โ€” Community Bug Fixes
  • Autopilot model routing โ€” Provider models now route through openclaw/default with the original model in x-openclaw-model, fixing 404 errors on OpenClaw deployments. (@Ahmedkasmi-dev, #109)
  • AUTOPILOT_MODEL env var โ€” Removed hardcoded model override in description generation so the shared AUTOPILOT_MODEL config is respected. (@aaronmeza, #116)
  • Gateway catalog sync โ€” Local agent role assignments are now preserved during gateway sync instead of being overwritten every 60 seconds. (@cgluttrell, #119)
  • Task chat reliability โ€” Agent replies are now captured even without an active SSE connection, and the "waiting" indicator no longer shows stale state. (@heliokeplert-ctrl, #126)
v2.4.0 โ€” Agent Skill Creation Loop
  • Agents learn reusable procedures from completed tasks
  • Bayesian confidence scoring promotes proven skills
  • Matched skills injected at dispatch as primary instructions
v2.0โ€“v2.3 โ€” Full changelog in Releases
  • v2.3.x โ€” Idea dedup, operator chat, swipe undo, A/B testing, auto-rollback
  • v2.2.x โ€” Preference learning, token tracking, health check endpoints, backup API
  • v2.1.x โ€” Server-side pipeline, error reporting, idea badges
  • v2.0.x โ€” Session key prefix, dispatch stability, community contributions

v2.0 Highlights

Autensa v2 is a ground-up expansion from task orchestration dashboard to the world's first autonomous product improvement engine. It researches your market, generates feature ideas, lets you decide with a swipe, and builds them โ€” automatically.

๐Ÿ”ฌ Product Autopilot โ€” The Full Pipeline

The headline feature. Point Autensa at any product (repo + live URL) and it runs a continuous improvement loop:

  1. Autonomous Research โ€” AI agents analyze your codebase, scan your live site, and research your market: competitors, user intent, conversion patterns, SEO gaps, technical opportunities. Runs on configurable schedules โ€” daily, weekly, or on-demand.

  2. AI-Powered Ideation โ€” Research feeds into ideation agents that generate concrete, scored feature ideas. Each idea includes an impact score, feasibility score, size estimate, technical approach, and a direct link to the research that inspired it.

  3. Swipe to Decide โ€” Ideas appear as cards in a Tinder-style interface. Four actions:

    • Pass โ€” Rejected. The preference model learns from it.
    • Maybe โ€” Saved to the Maybe Pool. Resurfaces in 1 week with fresh context.
    • Yes โ€” Task created. Build agent starts coding.
    • Now! โ€” Urgent dispatch. Priority queue, immediate execution.
  4. Automated Build โ†’ PR โ€” Approved ideas flow through the full agent pipeline: Build agent implements the feature โ†’ Test agent runs the suite โ†’ Review agent inspects the diff โ†’ Pull request created on GitHub with full context.

Your only job is the swipe. Everything else is automated.

๐Ÿ“„ Product Program (Karpathy AutoResearch Pattern)

Inspired by Andrej Karpathy's AutoResearch architecture. Each product has a Product Program โ€” a living document that instructs research and ideation agents on what to look for, what matters, and what to ignore. The program evolves as swipe data accumulates: the system learns your taste, not just patterns.

๐Ÿš› Convoy Mode โ€” Parallel Multi-Agent Execution

Large features get decomposed into subtasks with a visual dependency graph (DAG). Multiple agents (3โ€“5) work simultaneously with dependency-aware scheduling:

  • Parallel subtask execution โ€” Independent pieces run concurrently
  • Dependency graph visualization โ€” See what depends on what
  • Health monitoring โ€” Detects stalled, stuck, or zombie agents automatically
  • Auto-nudge โ€” Reassigns or restarts agents that go dark
  • Crash recovery โ€” Checkpoints save agent progress; work resumes from last checkpoint, not from scratch

๐Ÿ’ฌ Operator Chat โ€” Talk to Agents Mid-Build

Don't wait for a PR to give feedback. Two communication modes:

  • Queued Notes โ€” Add context ("use the existing auth middleware") that gets delivered at the agent's next checkpoint
  • Direct Messages โ€” Delivered immediately to the agent's active session for real-time course correction

Full chat history preserved per task โ€” every message, note, and response.

๐Ÿ’ฐ Cost Tracking & Budget Caps

Granular spend visibility across every dimension:

  • Per-task cost tracking โ€” See exactly what each feature costs to build
  • Per-product aggregation โ€” Total spend across all tasks for a product
  • Daily and monthly caps โ€” Set budget limits that auto-pause dispatch when exceeded
  • Cost breakdown API โ€” Detailed reports by agent, model, and time period

๐Ÿง  Knowledge Base & Learner Agent

A dedicated Learner agent captures lessons from every build cycle โ€” what worked, what failed, what patterns emerged. Knowledge entries are injected into future dispatches so agents don't repeat mistakes.

๐Ÿ“‹ Enhanced Planning Phase

Before any build starts, agents run a structured planning phase:

  • AI asks clarifying questions about requirements and constraints
  • Generates a detailed spec from your answers
  • Multi-agent planning specs with sub-agent definitions and execution steps
  • Approval gate โ€” you review the plan before any code is written

๐Ÿ”„ Checkpoint & Crash Recovery

Agent progress is saved at configurable checkpoints:

  • If a session crashes, work resumes from the last checkpoint โ€” not from scratch
  • Checkpoint restore API for manual recovery
  • Checkpoint history visible per task

๐ŸŽฏ Preference Learning

Every swipe trains a per-product preference model:

  • Category weights (growth, SEO, UX, etc.) adjust based on approvals/rejections
  • Complexity preferences calibrate over time
  • Tag pattern recognition refines idea generation
  • Ideas get sharper with every iteration

๐Ÿ” Maybe Pool

Ideas you're not sure about don't disappear:

  • Swiped "Maybe" ideas enter a holding pool
  • Automatically resurface after a configurable period with new market context
  • Batch re-evaluation mode to review accumulated maybes
  • Can be promoted to Yes at any time

๐Ÿ“ก Live Activity Feed

Real-time SSE stream of everything happening across all products:

  • Research progress, ideation cycles, swipe events
  • Build progress, test results, review outcomes
  • Agent health events, cost updates, PR creation
  • Filterable by product, agent, and event type

๐Ÿ›ก๏ธ Automation Tiers

Choose your comfort level per product:

Tier Behavior Best For
Supervised PRs created automatically. You review and merge manually. Production apps
Semi-Auto PRs auto-merge when CI passes and review agent approves. Staging & trusted repos
Full Auto Everything automated end-to-end. Idea โ†’ deployed feature. Side projects & MVPs

๐Ÿ”€ Workspace Isolation

Each build task gets an isolated workspace:

  • Git Worktrees for repo-backed projects โ€” isolated branch, no conflicts with other agents
  • Task Sandboxes for local/no-repo projects โ€” dedicated directory under .workspaces/task-{id}/
  • Port allocation (4200โ€“4299 range) for dev servers โ€” no port conflicts between concurrent builds
  • Serialized merge queue โ€” completed tasks merge one at a time with conflict detection
  • Product-scoped locking โ€” concurrent completions for the same product queue automatically

๐Ÿ“Š Product Scheduling

Configure autonomous cycles per product:

  • Research frequency (daily, weekly, custom cron)
  • Ideation frequency (after each research cycle, or independent schedule)
  • Auto-dispatch rules (immediate on "Yes" swipe, or batch)
  • Schedule management UI with enable/disable per schedule

โœจ Features

Product Autopilot

  • ๐Ÿ”ฌ Autonomous market research (competitors, SEO, user intent, technical gaps)
  • ๐Ÿ’ก AI-powered ideation with impact/feasibility scoring
  • ๐Ÿ‘† Swipe interface for instant approve/reject/maybe decisions
  • ๐Ÿ“„ Product Program (Karpathy AutoResearch pattern)
  • ๐ŸŽฏ Preference learning from swipe history
  • ๐Ÿ” Maybe Pool with auto-resurface
  • ๐Ÿ“Š Configurable research & ideation schedules

Agent Orchestration

  • ๐Ÿค– Multi-agent pipeline (Builder โ†’ Tester โ†’ Reviewer โ†’ Learner)
  • ๐Ÿš› Convoy Mode for parallel multi-agent execution
  • ๐Ÿ’ฌ Operator Chat (queued notes + direct messages)
  • ๐Ÿ’š Agent health monitoring with auto-nudge
  • ๐Ÿ”„ Checkpoint & crash recovery
  • ๐Ÿง  Knowledge base with cross-task learning
  • ๐Ÿ”€ Workspace isolation (git worktrees + task sandboxes)

Task Management

  • ๐ŸŽฏ Kanban board with drag-and-drop across 7 status columns
  • ๐Ÿง  AI planning phase with clarifying Q&A
  • ๐Ÿ“‹ Multi-agent planning specs
  • ๐Ÿ–ผ๏ธ Task image attachments (UI mockups, screenshots)
  • ๐Ÿ“ก Live real-time activity feed (SSE)
  • ๐Ÿ’ฐ Per-task, per-product, daily/monthly cost tracking & caps

Infrastructure

  • ๐Ÿ”Œ OpenClaw Gateway integration (WebSocket)
  • ๐Ÿ”— Gateway agent discovery & import
  • ๐Ÿณ Docker ready (production-optimized)
  • ๐Ÿ”’ Bearer token auth, HMAC webhooks, Zod validation
  • ๐Ÿ›ก๏ธ Privacy first โ€” no trackers, no centralized data collection
  • ๐ŸŒ Multi-machine support (Tailscale compatible)
  • ๐Ÿ›ก๏ธ Automation tiers (Supervised / Semi-Auto / Full Auto)

๐Ÿ›ก๏ธ Privacy

Autensa is open-source and self-hosted. The project does not include ad trackers, third-party analytics beacons, or a centralized data collector.

Your task data, research results, ideas, swipe history, and product programs stay in your own deployment (SQLite + workspace). If you connect external services (AI providers or remote gateways), only the data you explicitly send to those services leaves your environment.


๐Ÿ— Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                          YOUR MACHINE                                โ”‚
โ”‚                                                                      โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
โ”‚  โ”‚ Autensa           โ”‚โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚    OpenClaw Gateway              โ”‚  โ”‚
โ”‚  โ”‚  (Next.js)        โ”‚   WS     โ”‚  (AI Agent Runtime)              โ”‚  โ”‚
โ”‚  โ”‚  Port 4000        โ”‚          โ”‚  Port 18789                      โ”‚  โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
โ”‚           โ”‚                                  โ”‚                       โ”‚
โ”‚           โ–ผ                                  โ–ผ                       โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
โ”‚  โ”‚    SQLite DB       โ”‚          โ”‚     AI Providers                โ”‚  โ”‚
โ”‚  โ”‚  (tasks, products, โ”‚          โ”‚  (Anthropic / OpenAI / etc.)    โ”‚  โ”‚
โ”‚  โ”‚   ideas, costs)    โ”‚          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                                                โ”‚
โ”‚           โ”‚                                                          โ”‚
โ”‚           โ–ผ                                                          โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”   โ”‚
โ”‚  โ”‚              Autopilot Engine                                  โ”‚   โ”‚
โ”‚  โ”‚  Research โ†’ Ideation โ†’ Swipe โ†’ Build โ†’ Test โ†’ Review โ†’ PR     โ”‚   โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Autensa = The dashboard + autopilot engine (this project) OpenClaw Gateway = The AI runtime that executes tasks (separate project)


๐Ÿš€ Quick Start

Prerequisites

  • Node.js v18+ (download)
  • OpenClaw Gateway โ€” npm install -g openclaw
  • AI API Key โ€” Anthropic (recommended), OpenAI, Google, or others via OpenRouter

Install

# Clone
git clone https://github.com/crshdn/mission-control.git
cd mission-control

# Install dependencies
npm install

# Setup
cp .env.example .env.local

Edit .env.local:

OPENCLAW_GATEWAY_URL=ws://127.0.0.1:18789
OPENCLAW_GATEWAY_TOKEN=your-token-here

Where to find the token: Check ~/.openclaw/openclaw.json under gateway.token

Run

# Start OpenClaw (separate terminal)
openclaw gateway start

# Start Autensa
npm run dev

Open http://localhost:4000 โ€” you're in! ๐ŸŽ‰

Production

npm run build
npx next start -p 4000

๐Ÿณ Docker

You can run Autensa in a container using the included Dockerfile and docker-compose.yml.

Prerequisites

  • Docker Desktop (or Docker Engine + Compose plugin)
  • OpenClaw Gateway running locally or remotely

1. Configure environment

Create a .env file for Compose:

cp .env.example .env

Then set at least:

OPENCLAW_GATEWAY_URL=ws://host.docker.internal:18789
OPENCLAW_GATEWAY_TOKEN=your-token-here

Notes:

  • Use host.docker.internal when OpenClaw runs on your host machine.
  • If OpenClaw is on another machine, set its reachable ws:// or wss:// URL instead.

2. Build and start

docker compose up -d --build

Open http://localhost:4000.

3. Useful commands

# View logs
docker compose logs -f mission-control

# Stop containers
docker compose down

# Stop and remove volumes (deletes SQLite/workspace data)
docker compose down -v

Data persistence

Compose uses named volumes:

  • mission-control-data for SQLite (/app/data)
  • mission-control-workspace for workspace files (/app/workspace)

๐ŸŽฏ How It Works

The Autopilot Pipeline

RESEARCH โ†’ IDEATION โ†’ SWIPE โ†’ PLAN โ†’ BUILD โ†’ TEST โ†’ REVIEW โ†’ PR
   AI          AI      You      AI     Agent   Agent   Agent   Auto
  1. Research โ€” AI analyzes your product's market: competitors, SEO, user intent, technical gaps
  2. Ideation โ€” Research feeds ideation agents that generate scored feature ideas
  3. Swipe โ€” You review ideas as cards. Pass / Maybe / Yes / Now!
  4. Plan โ€” AI asks clarifying questions, generates a detailed spec
  5. Build โ€” Agent clones repo, creates branch, implements the feature
  6. Test โ€” Agent runs the test suite. Failures bounce back for auto-fix
  7. Review โ€” Agent inspects the diff for quality, security, best practices
  8. PR โ€” Pull request created on GitHub with full context and research backing

Task Flow (Manual Tasks)

PLANNING โ†’ INBOX โ†’ ASSIGNED โ†’ IN PROGRESS โ†’ TESTING โ†’ REVIEW โ†’ DONE

Drag tasks between columns or let the system auto-advance them.

Convoy Mode (Large Features)

                    โ”Œโ”€ Subtask A (Agent 1) โ”€โ”€โ”
PARENT TASK โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค                        โ”œโ”€โ”€โ”€โ”€ MERGE & PR
                    โ”œโ”€ Subtask B (Agent 2) โ”€โ”€โ”ค
                    โ””โ”€ Subtask C (Agent 3) โ”€โ”€โ”˜
                         (depends on A)

Subtasks run in parallel with dependency-aware scheduling. Health monitoring detects stalls. Crash recovery via checkpoints.


โš™๏ธ Configuration

Environment Variables

Variable Required Default Description
OPENCLAW_GATEWAY_URL โœ… ws://127.0.0.1:18789 WebSocket URL to OpenClaw Gateway
OPENCLAW_GATEWAY_TOKEN โœ… โ€” Authentication token for OpenClaw
MC_API_TOKEN โ€” โ€” API auth token (enables auth middleware)
WEBHOOK_SECRET โ€” โ€” HMAC secret for webhook validation
DATABASE_PATH โ€” ./mission-control.db SQLite database location
WORKSPACE_BASE_PATH โ€” ~/Documents/Shared Base directory for workspace files
PROJECTS_PATH โ€” ~/Documents/Shared/projects Directory for project folders

Security (Production)

Generate secure tokens:

# API authentication token
openssl rand -hex 32

# Webhook signature secret
openssl rand -hex 32

Add to .env.local:

MC_API_TOKEN=your-64-char-hex-token
WEBHOOK_SECRET=your-64-char-hex-token

When MC_API_TOKEN is set:

  • External API calls require Authorization: Bearer <token>
  • Browser UI works automatically (same-origin requests are allowed)
  • SSE streams accept token as query param

See PRODUCTION_SETUP.md for the full production guide.


๐ŸŒ Multi-Machine Setup

Run Autensa on one machine and OpenClaw on another:

# Point to the remote machine
OPENCLAW_GATEWAY_URL=ws://YOUR_SERVER_IP:18789
OPENCLAW_GATEWAY_TOKEN=your-shared-token
OPENCLAW_GATEWAY_URL=wss://your-machine.tailnet-name.ts.net
OPENCLAW_GATEWAY_TOKEN=your-shared-token

๐Ÿ—„ Database

SQLite database auto-created at ./mission-control.db. Migrations run automatically on startup (21 migrations). As of v2.0.1, a timestamped backup is created before any pending migration runs.

# Reset (start fresh)
rm mission-control.db

# Inspect
sqlite3 mission-control.db ".tables"

Key tables added in v2: products, research_cycles, ideas, swipe_history, preference_models, maybe_pool, product_feedback, cost_events, cost_caps, product_schedules, operations_log, convoys, convoy_subtasks, agent_health, work_checkpoints, agent_mailbox, workspace_ports, workspace_merges.


๐Ÿ“ Project Structure

autensa/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/                    # Next.js pages & API routes
โ”‚   โ”‚   โ”œโ”€โ”€ api/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ tasks/          # Task CRUD, planning, dispatch, convoy, chat, workspace
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ products/       # Product CRUD, research, ideation, swipe, schedules
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agents/         # Agent management, health, mail, discovery
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ costs/          # Cost tracking, caps, breakdowns
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ convoy/         # Convoy mail endpoints
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ openclaw/       # Gateway proxy endpoints
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ webhooks/       # Agent completion webhooks
โ”‚   โ”‚   โ”œโ”€โ”€ settings/           # Settings page
โ”‚   โ”‚   โ””โ”€โ”€ workspace/[slug]/   # Workspace dashboard
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ MissionQueue.tsx    # Kanban board
โ”‚   โ”‚   โ”œโ”€โ”€ PlanningTab.tsx     # AI planning interface
โ”‚   โ”‚   โ”œโ”€โ”€ AgentsSidebar.tsx   # Agent panel
โ”‚   โ”‚   โ”œโ”€โ”€ LiveFeed.tsx        # Real-time events
โ”‚   โ”‚   โ”œโ”€โ”€ TaskModal.tsx       # Task create/edit
โ”‚   โ”‚   โ”œโ”€โ”€ TaskChatTab.tsx     # Operator chat
โ”‚   โ”‚   โ”œโ”€โ”€ ConvoyTab.tsx       # Convoy visualization
โ”‚   โ”‚   โ”œโ”€โ”€ DependencyGraph.tsx # DAG visualization
โ”‚   โ”‚   โ”œโ”€โ”€ HealthIndicator.tsx # Agent health badges
โ”‚   โ”‚   โ”œโ”€โ”€ WorkspaceTab.tsx    # Workspace isolation UI
โ”‚   โ”‚   โ”œโ”€โ”€ autopilot/          # SwipeDeck, IdeaCard, ResearchReport, etc.
โ”‚   โ”‚   โ””โ”€โ”€ costs/              # Cost dashboard components
โ”‚   โ””โ”€โ”€ lib/
โ”‚       โ”œโ”€โ”€ autopilot/          # Research, ideation, swipe, maybe-pool, scheduling
โ”‚       โ”œโ”€โ”€ costs/              # Cost tracker, caps, reporting
โ”‚       โ”œโ”€โ”€ db/                 # SQLite + 21 migrations
โ”‚       โ”œโ”€โ”€ openclaw/           # Gateway client + device identity
โ”‚       โ”œโ”€โ”€ convoy.ts           # Convoy orchestration
โ”‚       โ”œโ”€โ”€ agent-health.ts     # Health monitoring + auto-nudge
โ”‚       โ”œโ”€โ”€ checkpoint.ts       # Checkpoint save/restore
โ”‚       โ”œโ”€โ”€ workspace-isolation.ts # Git worktrees + task sandboxes
โ”‚       โ”œโ”€โ”€ mailbox.ts          # Inter-agent messaging
โ”‚       โ”œโ”€โ”€ chat-listener.ts    # Operator chat relay
โ”‚       โ”œโ”€โ”€ learner.ts          # Knowledge base management
โ”‚       โ””โ”€โ”€ types.ts            # TypeScript types
โ”œโ”€โ”€ presentation/               # v2 pitch deck + narration script
โ”œโ”€โ”€ specs/                      # Feature specs
โ”œโ”€โ”€ scripts/                    # Bridge & hook scripts
โ””โ”€โ”€ CHANGELOG.md                # Full version history

๐Ÿ”ง Troubleshooting

Can't connect to OpenClaw Gateway

  1. Check OpenClaw is running: openclaw gateway status
  2. Verify URL and token in .env.local
  3. Check firewall isn't blocking port 18789

Planning questions not loading

  1. Check OpenClaw logs: openclaw gateway logs
  2. Verify your AI API key is valid
  3. Refresh and click the task again

Port 4000 already in use

lsof -i :4000
kill -9 <PID>

Agent callbacks failing behind a proxy (502 errors)

If you're behind an HTTP proxy (corporate VPN, Hiddify, etc.), agent callbacks to localhost may fail because the proxy intercepts local requests.

Fix: Set NO_PROXY so localhost bypasses the proxy:

# Linux / macOS
export NO_PROXY=localhost,127.0.0.1

# Windows (cmd)
set NO_PROXY=localhost,127.0.0.1

# Docker
docker run -e NO_PROXY=localhost,127.0.0.1 ...

See Issue #30 for details.


๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'feat: add amazing feature'
  4. Push: git push origin feature/amazing-feature
  5. Open a Pull Request

๐Ÿ‘ Contributors

Autensa is built by a growing community. Thank you to everyone who has contributed!

Steve
Steve

Device Identity
Ryan Christman
Ryan Christman

Port Configuration
nicozefrench
nicozefrench

ARIA Hooks
GOPAL
GOPAL

Node v25 Support
Jorge Martinez
Jorge Martinez

Orchestration
Nik
Nik

Planning & Dispatch
Michael G
Michael G

Usage Dashboard
Z8Medina
Z8Medina

Metabase Integration
Mark Phelps
Mark Phelps

Gateway Agent Discovery ๐Ÿ’ก
Alessio
Alessio

Docker Support
James Tsetsekas
James Tsetsekas

Planning Flow Fixes
nice-and-precise
nice-and-precise

Agent Protocol Docs
JamesCao2048
JamesCao2048

Task Creation Fix
davetha
davetha

Force-Dynamic & Model Discovery
pkgaiassistant-droid
pkgaiassistant-droid

Activity Dashboard & Mobile UX
Coder-maxer
Coder-maxer

Static Route Fix
grunya-openclaw
grunya-openclaw

Dispatch & Proxy Bug Reports
ilakskill
ilakskill

Dispatch Recovery Design
plutusaisystem-cmyk
plutusaisystem-cmyk

Agent Daemon & Fleet View
nithis4th
nithis4th

2nd Brain Knowledge Base
davidpellerin
davidpellerin

Dynamic Agent Config
tmchow
tmchow

Agent Import Improvements
xiaomiusa87
xiaomiusa87

Session Key Bug Report
lutherbot-ai
lutherbot-ai

Security Audit
YITING OU
YITING OU

Cascade Delete Fix
Brandon Ros
Brandon Ros

Docker CI Workflow
nano-lgtm
nano-lgtm

Kanban UX Improvements
cammybot1313-collab
cammybot1313-collab

Docs Typo Fix

โญ Star History

Star History Chart

๐Ÿ“œ License

MIT License โ€” see LICENSE for details.


๐Ÿ™ Acknowledgments

OpenClaw Next.js Tailwind CSS SQLite Anthropic


โ˜• Support

If Autensa has been useful to you, consider buying me a coffee!

Buy Me A Coffee

Join Our Discord

Stop managing a backlog. Start shipping on autopilot. ๐Ÿš€

Related repositories
illacloud/illa-builder

Low-code platform allows you to build business apps, enables you to quickly create internal tools such as dashboard, crud app, admin panel, crm, cms, etc. Supports PostgreSQL, MySQL, Supabase, GraphQL, MongoDB, MSSQL, Rest API, Hugging Face, Redis, etc. Automate workflows with schedule or webhook. Open source Retool.

TypeScriptnpmApache License 2.0internal-toolinternal-tools
12.3k1.2k
The-Pocket/PocketFlow

Pocket Flow: 100-line LLM framework. Let Agents build Agents!

PythonPyPIMIT Licenseagentsflow-based-programming
the-pocket.github.io/PocketFlow/
11k1.2k
mrexodia/ida-pro-mcp

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

PythonPyPIMIT Licenseida-pluginida-pro
plugins.hex-rays.com/mrexodia/ida-pro-mcp
10.6k1.2k
linyqh/NarratoAI

NarratoAI๏ผšๅผ€ๆบ AI ่งฃ่ฏดไธŽ่‡ชๅŠจๅŒ–ๅ‰ช่พ‘ๅทฅๅ…ท๏ผŒๆ”ฏๆŒๅฝฑ่ง†/็Ÿญๅ‰งๆ–‡ๆกˆใ€้…้Ÿณใ€ๅญ—ๅน•ๅ’Œไธ€้”ฎๆˆ็‰‡๏ผ›ไธŽโ€œAI ่งฃ่ฏดๅคงๅธˆโ€้žๅŒไธ€้กน็›ฎใ€‚

PythonPyPIMIT Licenseaiagentaiops
narratoai.co
10.4k1.4k
MervinPraison/PraisonAI

PraisonAI ๐Ÿฆž โ€” Hire a 24/7 AI Workforce. Stop writing boilerplate and start shipping autonomous self-improving agents that research, plan, code, and execute tasks. Deployed in 5 lines of code with built-in memory, RAG, and support for 100+ LLMs.

PythonPyPIMIT Licenseagentsai
praison.ai/docs
8.5k1.3k
AI4Finance-Foundation/FinRobot

FinRobot: An Open-Source AI Agent Platform for Financial Analysis using LLMs ๐Ÿš€ ๐Ÿš€ ๐Ÿš€

Jupyter NotebookApache License 2.0aiagentfingpt
finrobot.ai
7.6k1.3k
logancyang/obsidian-copilot

THE Copilot in Obsidian

TypeScriptnpmGNU Affero General Public License v3.0chatgptcopilot
obsidiancopilot.com
7.4k695
11cafe/jaaz

The world's first open-source multimodal creative assistant This is a substitute for Canva and Manus that prioritizes privacy and is usable locally.

TypeScriptnpmOtheragentai
jaaz.app
6.4k641
chaterm/Chaterm

Open source AI terminal for cloud and infrastructure management, enabling you to deploy, troubleshoot, and automate services using natural language and intelligent agents.

TypeScriptnpmOthercursorcyberark
chaterm.ai
3k286
MARKTECHPOST-AI-MEDIA-INC/AI-Agents-Projects-Tutorials

Multi-agent systems, memory, planning, reasoning loops

Jupyter Notebookaiagentsagent-skills
marktechpost.com
2.8k612
Agent-Field/agentfield

Build, run and scale AI agents like API and microservices

GoGo ModulesApache License 2.0agentagentic-ai
agentfield.ai
2.4k384
jim-schwoebel/awesome_ai_agents

๐Ÿค– A comprehensive list of 1,500+ resources and tools related to AI agents.

Apache License 2.0agent-based-modelingagentic
agents.blog
1.9k623