Waynode AI

Open-source, self-hosted coding-agent workspace. Each workspace is a real cloned repo. pi is the engine, with pi-codex-goal as a first-class citizen.

Mobile-first. Small-team ready. macOS + iOS clients planned.

Quick Start

Self-host (Docker)

git clone https://github.com/fornace/waynode.git
cd waynode
cp .env.example .env
# Edit .env — set SESSION_SECRET, ENCRYPTION_KEY, and OAuth credentials
docker compose up -d
# → http://localhost:3000

Local Development

# Terminal 1: backend
npm install
cp .env.example .env
npm run dev

# Terminal 2: frontend (hot reload)
cd frontend
npm install
npm run dev

OAuth Setup

GitHub

1. Go to GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
2. Set Authorization callback URL to https://your-domain/auth/github/callback
3. Copy the Client ID and generate a Client Secret
4. Put them in .env as GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET

GitLab

1. Go to GitLab → User Settings → Applications → New Application
2. Set Redirect URI to https://your-domain/auth/gitlab/callback
3. Scopes: read_user, read_api, read_repository
4. Put them in .env as GITLAB_CLIENT_ID / GITLAB_CLIENT_SECRET

Architecture

┌─────────────────────────────────────────────────┐
│  Clients: Web (React) │ macOS (Tauri) │ iOS      │
├─────────────────────────────────────────────────┤
│  Express server                                 │
│  • GitHub + GitLab OAuth                        │
│  • Space = cloned repo on disk                  │
│  • Session = pi session (JSONL-backed)          │
│  • Spawns pi -p per message, streams SSE        │
│  • SQLite: secrets, metadata, session index     │
│  • Terminal: node-pty → WebSocket → xterm.js   │
├─────────────────────────────────────────────────┤
│  pi runtime (per-space working directory)        │
│  • pi-codex-goal preinstalled                    │
│  • AGENTS.md + skills/ per space                 │
└─────────────────────────────────────────────────┘

Key Concepts

Concept	Description
Space	A cloned git repository. Each space has its own AGENTS.md, skills, and sessions.
Session	A conversation within a space. Backed by pi's JSONL session format.
Chat tab	Structured conversation via pi -p (headless), streamed over SSE.
Terminal tab	Full pi TUI via node-pty → WebSocket → xterm.js. For /goal, model switching, raw power.
Goal mode	Send-as-Goal wraps your prompt to instruct pi to use create_goal and run autonomously.
Secrets	AES-256 encrypted, stored in SQLite. Scoped globally or per-space. Injected as env vars to pi.

License

MIT