\n \n
\n Self-hosted Vibe Coding platform for Claude Code
\n Browser terminal · AI tasks · Remote access · Telegram bot\n
\n ![\"npm\"](\"https://img.shields.io/npm/v/@aion0/forge\")
![\"MIT\"](\"https://img.shields.io/npm/l/@aion0/forge\")
![\"stars\"](\"https://img.shields.io/github/stars/aiwatching/forge?style=social\")
\n Watch Demo →\n
\n\n---\n\n## Demo & Install Guide\n\n[](https://www.youtube.com/watch?v=F3fiSiP3pZY)\n\n## Install\n\n**One-liner** (macOS + Linux — installs node deps, tmux, claude code, then Forge):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/aiwatching/forge/main/scripts/install-deps.sh | bash\n```\n\nOr manually:\n\n```bash\nnpm install -g @aion0/forge\nforge server start\n```\n\nOpen `http://localhost:8403`. First launch prompts you to set an admin password.\n\n**Requirements:** Node.js ≥ 20, tmux, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)\n**Optional:** jq, glab, gh (used by some pipelines)\n\n## What is Forge?\n\nForge turns Claude Code into a remote-accessible coding platform. Run it on your machine, access from any device.\n\n- **Vibe Code anywhere** — iPad, phone, any browser. Persistent tmux sessions survive refresh/restart\n- **Background AI tasks** — Submit prompts that run while you sleep. Live output, cost tracking\n- **Pipeline workflows** — Chain Claude Code steps in YAML (design → implement → review)\n- **Remote access** — One-click Cloudflare Tunnel, no account needed\n- **Telegram bot** — Create tasks, check status, take notes from your phone\n- **Skills marketplace** — Browse & install Claude Code slash commands\n\nNo API keys required. Uses your existing Claude Code subscription. Code never leaves your machine.\n\n## Multi-Agent Workspace v0.5.0\n\nDefine agent teams with roles, dependencies, and steps. Agents run as daemons and communicate via a structured message bus.\n\n```mermaid\ngraph LR\n Input[\"📋 Requirements\"] --> PM[\"🎯 PM\"]\n PM --> Eng[\"🔨 Engineer\"]\n Eng --> QA[\"🧪 QA\"]\n Eng --> Rev[\"👁 Reviewer\"]\n QA --> Rev\n\n style Input fill:#f0883e,stroke:#f0883e,color:#fff\n style PM fill:#a371f7,stroke:#a371f7,color:#fff\n style Eng fill:#58a6ff,stroke:#58a6ff,color:#fff\n style QA fill:#3fb950,stroke:#3fb950,color:#fff\n style Rev fill:#f778ba,stroke:#f778ba,color:#fff\n```\n\n- **Agent profiles** — Reusable configs with env vars, model overrides, custom API endpoints (Claude, Codex, Aider)\n- **Message system** — Notifications (follow DAG) + Tickets (any direction, retry limits) with causedBy tracing\n- **Manual mode** — Open a terminal on any agent, work interactively, return to auto\n- **Watch manager** — Monitor files, git, or commands. Auto-analyze or require approval on changes\n\n## Features\n\n| | |\n|---|---|\n| **Multi-Agent Workspace** | Agent teams with DAG dependencies, message bus, watch monitoring, manual/auto mode |\n| **Vibe Coding** | Browser tmux terminal, multi-tab, split panes, WebGL, Ctrl+F search |\n| **AI Tasks** | Background Claude Code execution with live streaming output |\n| **Pipelines** | YAML DAG workflows with parallel execution & visual editor |\n| **Remote Access** | Cloudflare Tunnel with 2FA (password + session code) |\n| **Docs Viewer** | Obsidian / markdown rendering with AI assistant |\n| **Projects** | File browser, git operations, code viewer with syntax highlighting, diff view |\n| **Skills** | Marketplace for skills & commands — browse, install, update, version tracking |\n| **Telegram** | Tasks, sessions, notes, tunnel control from mobile |\n| **CLI** | `forge task`, `forge watch`, `forge status`, and more |\n\n## Quick Start\n\n```bash\nforge server start # start (background by default)\nforge server start --foreground # run in foreground\nforge server start --dev # dev mode with hot-reload\nforge server stop # stop\nforge server restart # restart\n```\n\n### From source\n\n```bash\ngit clone https://github.com/aiwatching/forge.git\ncd forge && pnpm install\n./start.sh # production\n./start.sh dev # development\n```\n\n## CLI\n\n```bash\nforge task