Skip to content

wherexml/OptiONE

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,134 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OptiONE

AI-native task management for human + agent teams.

OptiONE is an open-source platform that turns coding agents into real teammates. Assign tasks to AI agents like you'd assign to a colleague — they pick up work, write code, report blockers, and update statuses autonomously. Designed for 2-10 person AI-native teams.

Features

  • Agents as Teammates — assign issues to agents with profiles, comments, and proactive blocker reports
  • Autonomous Execution — full task lifecycle (enqueue → claim → start → complete/fail) with real-time WebSocket progress
  • Reusable Skills — every solution compounds into a reusable skill for the whole team
  • Unified Runtimes — one dashboard for local daemons and cloud runtimes, auto-detects available CLIs
  • Workflow Hub — workflow and knowledge-base surface prepared for Dify integration
  • Multi-Workspace — workspace-level isolation with independent agents, issues, and settings
  • Password Auth — built-in email + password authentication for self-hosted deployments

Architecture

OptiONE Architecture

Layer Stack
Frontend Next.js 16 (App Router, TypeScript, Zustand)
Backend Go 1.26 (Chi, sqlc, gorilla/websocket)
Database PostgreSQL 17 + pgvector
Agent Runtime Claude Code, Codex, OpenClaw, OpenCode
Dify Source Vendored under dify/ as an isolated upstream snapshot
Deployment Docker Compose

Quick Start (Self-Hosted)

Prerequisites

Deploy with Docker

# Clone the repo
git clone https://github.com/wherexml/OptiONE.git
cd OptiONE

# Configure and deploy
./scripts/deploy-container.sh --env-file .env.container
Service Port
PostgreSQL 22200
Backend 22201
Frontend 22202

Open http://localhost:22202 and log in with the default admin account.

The deploy script starts Web/API/PostgreSQL in Docker, then configures the host machine with:

multica --profile local setup --local --port 22201 --frontend-port 22202
multica --profile local daemon status

Claude Code must be installed and logged in on the host machine as claude; it is not run inside Docker.

Local Development

# One-command setup
make setup     # DB + migrations + dependencies
make start     # Start backend + frontend concurrently

# Or start individually
make dev       # Go backend (port 8080)
pnpm dev:web   # Next.js frontend (port 3000)

Common commands:

make check          # Type check + tests + lint
make test           # Run tests
make sqlc           # Regenerate SQL queries after schema changes
make db-up/down     # Manage PostgreSQL container

CLI

multica login            # Authenticate
multica daemon start     # Start local agent runtime
multica daemon status    # Check daemon status
multica issue list       # List issues
multica issue create     # Create an issue
multica update           # Update to latest version

Agent Workflow

  1. Start the daemonmultica daemon start connects your machine as a runtime
  2. Create an agent — Settings → Agents → pick a runtime and provider
  3. Assign a task — Create an issue and assign it to the agent
  4. Monitor progress — Real-time updates on the board via WebSocket

Documentation

Document Description
docs/README.md Documentation index
docs/dify.md Dify source snapshot, boundaries, and OptiONE integration notes
ARCHITECTURE.md System architecture, diagrams, data flow
frontend.md Frontend components, state management, routing
backend.md Handler/Service/EventBus/Agent SDK
database.md Schema, migrations, sqlc usage
api_contract.md REST + WebSocket API definitions
deployment.md Deployment configuration and environment variables
DEPLOY_CONTAINER.md Container deployment guide
CONTRIBUTING.md Development workflow and contributing guidelines

License

This project is licensed under the Apache License 2.0.

About

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 53.0%
  • Python 40.0%
  • JavaScript 2.4%
  • Go 2.3%
  • MDX 1.4%
  • CSS 0.4%
  • Other 0.5%