teamoon

🌙 teamoon

Development autopilot powered by Claude Code. Monitor token usage, manage task queues, and run autonomous multi-step workflows across your projects — from a web dashboard or terminal UI.

---

📑 Table of Contents

• Features
• Quick Start
• Web Dashboard
• TUI Dashboard
• CLI
• Autopilot
• Configuration
• CI/CD
• Contributing
• Contact
• License

---

✨ Features

• 📊 Real-time monitoring — Token consumption, cost tracking (daily/weekly/monthly), session counts, and context window usage with live SSE updates
• 📋 Task queue — Priority-based task management (high/med/low) with time tracking, filtering, and bulk operations
• 🗂️ Kanban board — Visual drag-and-drop board for organizing tasks across states
• 🤖 Autopilot engine — Automated task execution via Claude CLI with multi-step planning, build verification, test execution, and auto-commit
• 📁 Project discovery — Auto-scan your workspace for projects with git branch info, modified files, and last commit details
• ⚡ Skeleton steps — Configurable execution phases per project (investigate, context7, implement, build, test, security review, pre-commit, commit, push)
• 🌐 Chrome DevTools — Automated browser verification via MCP — take screenshots, inspect DOM, and check console errors during autopilot
• 🔌 MCP server management — Install, configure, and toggle MCP servers from the web UI with a searchable catalog
• 💬 Chat interface — Interact with Claude directly from the dashboard
• 🧙 Setup wizard — Ubuntu installer-style onboarding that checks, installs, and configures everything step by step
• 🖥️ Dual mode — Full-featured web SPA and terminal UI (Bubbletea) from a single binary
• 🗄️ Log retention — Configurable log retention with automatic cleanup of old entries

---

🚀 Quick Start

Quick Install

Single command that installs all prerequisites and teamoon:

curl -sSL https://raw.githubusercontent.com/JuanVilla424/teamoon/main/install.sh | bash

Installs system packages, Go, Node.js, Python, Rust, GitHub CLI, Claude Code, then builds and installs teamoon as a service. Skips anything already installed — safe to re-run.

Supports Ubuntu/Debian, RHEL/Rocky Linux 8+, and macOS (Apple Silicon + Intel). See INSTALL.md for full details.

Manual Install

git clone https://github.com/JuanVilla424/teamoon.git
cd teamoon
make build
make install

Prerequisites: Go 1.24+, Node.js 18+, Git, Make. Works on Linux and macOS.

🧙 Onboarding

After installation, start the web server and open your browser:

teamoon serve

Open http://localhost:7777. On first visit, the setup wizard launches automatically and walks you through configuring prerequisites, skills, hooks, and MCP servers.

Both web and CLI (teamoon init) configure:

1. Prerequisites — verifies and installs required tools
2. Config — creates ~/.config/teamoon/config.json
3. Skills — 21 Claude Code agent skills (superpowers + anthropic + vercel)
4. BMAD — project management framework commands
5. Hooks — global security hooks for Claude Code
6. MCP Servers — Context7, Memory, Sequential Thinking, Chrome DevTools

🔧 Make Targets

Target	Description
build	Compile the binary
test	Run all tests (go test ./internal/...)
install	Build + install binary + systemd service
service	Alias for install
release	Cross-compile binary (used by CI/CD)
clean	Remove compiled binary

🔒 Pre-Commit Hooks

pip install pre-commit
pre-commit install
pre-commit install --hook-type pre-push

---

🌐 Web Dashboard

🔐 Login

Session-based authentication with password protection. Supports dark and light themes.

Dark	Light

📊 Overview

Real-time dashboard showing tokens, sessions, cost, context usage, queue summary, and recent activity — all updated via Server-Sent Events.

Dark	Light

📋 Queue

Priority-sorted task list with inline controls to run, stop, replan, or archive tasks. Filter by state, project, or priority. Wave badges for batch execution grouping.

🗂️ Board

Kanban-style board with tasks organized by state. Drag and drop to move tasks between columns.

📁 Projects

Auto-discovered projects from your workspace showing git branch, modified file count, and last commit. Click any project for a detailed view with tasks, skeleton config, and recent activity.

📝 Logs

Filterable log stream with level, task, project, and agent filters. Auto-scrolls to latest entries. Retention configurable (default 20 days).

💬 Chat

Direct chat interface for interacting with Claude. Send messages, view responses with per-turn cost tracking.

⚙️ Jobs

Scheduled cron jobs for automated tasks. Configure schedule, project, and description per job.

⚙️ Configuration

Manage paths, server settings, limits, autopilot parameters, skeleton steps, and MCP servers. Install MCP servers from the official registry.

---

🖥️ TUI Dashboard

teamoon

Full terminal dashboard with the same monitoring capabilities.

⌨️ Keyboard Shortcuts

Key	Action
esc / q	Quit
r	Refresh data
tab	Switch focus between QUEUE and PROJECTS
Up/Down	Navigate items
enter	Open project actions / view task detail
d	Mark task as done (in QUEUE)
a	Toggle auto-pilot on selected task (in QUEUE)
ctrl+a	Toggle auto-pilot on ALL tasks (in QUEUE)
p	Generate plan for task (in QUEUE)
x	Replan task (in QUEUE)
e	Archive task (in QUEUE)

📂 Project Actions Menu

Key	Action
1	Merge all dependabot PRs
2	Git pull
3	View open PRs
4	Add task for this project
esc / q	Close menu

---

⌨️ CLI

# Add a task
teamoon task add "implement auth module" -p my-project -r high

# Mark task as done
teamoon task done 3

# List pending tasks
teamoon task list

---

🤖 Autopilot

The autopilot engine executes tasks autonomously through configurable skeleton steps:

1. 🔍 Investigate — Analyze the codebase and understand the task
2. 🌐 Web Search — Research relevant information online
3. 📚 Context7 Lookup — Fetch up-to-date library documentation via MCP
4. 💻 Implement — Write the code changes
5. 🔨 Build Verify — Compile and verify the build succeeds
6. 🧪 Test — Run the test suite
7. 🛡️ Security Review — Scan for vulnerabilities using Claude Code Security (/security-review)
8. ✅ Pre-commit — Execute pre-commit hooks
9. 📦 Commit — Create a git commit with the changes
10. 🚀 Push — Push to remote (disabled by default)

🌐 Browser Verification — When Chrome DevTools MCP is enabled, autopilot agents can take screenshots, inspect the DOM, and check for console errors to verify UI changes visually.

Each step can be enabled/disabled per-project via the skeleton configuration. Failed tasks can be resumed with a single click.

🔄 Concurrency — Run up to N tasks in parallel across different projects (configurable via max_concurrent).

♻️ Recovery — Tasks in progress automatically resume after service restarts.

---

⚙️ Configuration

Stored at ~/.config/teamoon/config.json. Editable from the web UI under Config > General.

Field	Type	Default	Description
projects_dir	string	~/Projects	Directory to scan for projects
claude_dir	string	~/.claude	Claude Code data directory
refresh_interval_sec	int	30	Dashboard refresh interval in seconds
context_limit	int	0	Context window limit (0 = model default)
log_retention_days	int	20	Days to retain log entries
web_enabled	bool	false	Enable web dashboard on startup
web_port	int	7777	Web dashboard port
web_password	string	""	Session auth password, bcrypt hash (empty = no auth)
webhook_url	string	""	Webhook URL for task event notifications
max_concurrent	int	3	Max concurrent autopilot sessions

🎛️ Spawn Settings (spawn)

Field	Type	Default	Description
model	string	""	Claude model override (empty = default)
effort	string	""	Effort level override (empty = default)
max_turns	int	15	Max agentic turns per step
step_timeout_min	int	4	Max minutes per step before timeout (0 = none)

⚡ Skeleton Settings (skeleton)

Configurable per-project via project_skeletons map.

Field	Type	Default	Description
doc_setup	bool	true	Enable investigation/doc setup step
web_search	bool	true	Enable web search step
build_verify	bool	true	Enable build verification step
test	bool	true	Enable test execution step
security_review	bool	true	Enable Claude Code Security scan (/security-review)
pre_commit	bool	true	Enable pre-commit hooks step
commit	bool	true	Enable auto-commit step
push	bool	false	Enable auto-push step

---

🛠️ Development

See DEVELOPMENT.md for detailed development environment setup, Claude Code skills catalog, security hooks reference, and manual installation commands.

---

🔄 CI/CD

📋 Workflows

Workflow	Trigger	Description
Go	Push to dev/test/prod/main, PR	Go vet, tests, build
CI	Push to main, PR	Go vet, tests, build on main branch
Version Controller	Push to dev/test/prod/main	Auto version bump, tag creation, PR promotion
Release Controller	Tag v*.*.* (main only)	Cross-compiled binaries (5 platforms) + GitHub Release

📦 Release Artifacts

Binaries for Linux (amd64/arm64), macOS (amd64/arm64), and Windows (amd64). Each release includes SHA256SUMS for integrity verification.

🔀 Branch Promotion

dev → test → prod → main

Version bump keywords in commit messages: [major candidate], [minor candidate], [patch candidate].

---

🤝 Contributing

We welcome contributions! Please read our Contributing Guidelines and Code of Conduct before getting started.

📬 Contact

• GitHub Issues: github.com/JuanVilla424/teamoon/issues
• Email: r6ty5r296it6tl4eg5m.constant214@passinbox.com

📜 License

2026 - This project is licensed under the GNU General Public License v3.0. You are free to use, modify, and distribute this software under the terms of the GPL-3.0 license. For more details, please refer to the LICENSE file included in this repository.