@aion0/forge

Forge

Self-hosted Vibe Coding platform for Claude Code
Browser terminal · AI tasks · Remote access · Telegram bot

Watch Demo →

Demo & Install Guide

Install

One-liner (macOS + Linux — installs node deps, tmux, claude code, then Forge):

curl -fsSL https://raw.githubusercontent.com/aiwatching/forge/main/scripts/install-deps.sh | bash

Or manually:

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 Optional: jq, glab, gh (used by some pipelines)

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