Demo & Install Guide

Install

npm install -g @aion0/forge
forge server start

Open http://localhost:8403. First launch prompts you to set an admin password.

Requirements: Node.js ≥ 20, tmux, Claude Code CLI

What is Forge?

Forge turns Claude Code into a remote-accessible coding platform. Run it on your machine, access from any device.

• Vibe Code anywhere — iPad, phone, any browser. Persistent tmux sessions survive refresh/restart
• Background AI tasks — Submit prompts that run while you sleep. Live output, cost tracking
• Pipeline workflows — Chain Claude Code steps in YAML (design → implement → review)
• Remote access — One-click Cloudflare Tunnel, no account needed
• Telegram bot — Create tasks, check status, take notes from your phone
• Skills marketplace — Browse & install Claude Code slash commands

No API keys required. Uses your existing Claude Code subscription. Code never leaves your machine.

Multi-Agent Workspace v0.5.0

Define agent teams with roles, dependencies, and steps. Agents run as daemons and communicate via a structured message bus.

graph LR
    Input["📋 Requirements"] --> PM["🎯 PM"]
    PM --> Eng["🔨 Engineer"]
    Eng --> QA["🧪 QA"]
    Eng --> Rev["👁 Reviewer"]
    QA --> Rev

    style Input fill:#f0883e,stroke:#f0883e,color:#fff
    style PM fill:#a371f7,stroke:#a371f7,color:#fff
    style Eng fill:#58a6ff,stroke:#58a6ff,color:#fff
    style QA fill:#3fb950,stroke:#3fb950,color:#fff
    style Rev fill:#f778ba,stroke:#f778ba,color:#fff

• Agent profiles — Reusable configs with env vars, model overrides, custom API endpoints (Claude, Codex, Aider)
• Message system — Notifications (follow DAG) + Tickets (any direction, retry limits) with causedBy tracing
• Manual mode — Open a terminal on any agent, work interactively, return to auto
• Watch manager — Monitor files, git, or commands. Auto-analyze or require approval on changes

Features

| | | |---|---| | Multi-Agent Workspace | Agent teams with DAG dependencies, message bus, watch monitoring, manual/auto mode | | Vibe Coding | Browser tmux terminal, multi-tab, split panes, WebGL, Ctrl+F search | | AI Tasks | Background Claude Code execution with live streaming output | | Pipelines | YAML DAG workflows with parallel execution & visual editor | | Remote Access | Cloudflare Tunnel with 2FA (password + session code) | | Docs Viewer | Obsidian / markdown rendering with AI assistant | | Projects | File browser, git operations, code viewer with syntax highlighting, diff view | | Skills | Marketplace for skills & commands — browse, install, update, version tracking | | Telegram | Tasks, sessions, notes, tunnel control from mobile | | CLI | forge task, forge watch, forge status, and more |

Quick Start

forge server start              # start (background by default)
forge server start --foreground # run in foreground
forge server start --dev        # dev mode with hot-reload
forge server stop               # stop
forge server restart            # restart

From source

git clone https://github.com/aiwatching/forge.git
cd forge && pnpm install
./start.sh          # production
./start.sh dev      # development

CLI

forge task <project> <prompt>   # submit a task
forge tasks                     # list tasks
forge watch <id>                # live stream output
forge status                    # process status
forge tcode                     # show tunnel URL + session code
forge projects                  # list projects
forge flows                     # list workflows
forge run <flow>                # run a workflow
forge --reset-password               # reset admin password

Telegram Bot

Create a bot via @BotFather, add the token in Settings.

/task — create task · /tasks — list · /sessions — AI summary · /note — quick note · /tunnel_start — start tunnel · /watch — monitor session

Data

All data in ~/.forge/ — settings, database, terminal state, workflows, logs. Configurable via --dir flag.

License

MIT