artu-ai

Flow

Development dashboard and workflow automation for Claude Code.

Flow is a daemon-based process manager that runs a per-project development dashboard (SvelteKit + Monaco + xterm.js) and integrates with Linear and GitHub via Claude Code plugins.

Install

curl -fsSL https://raw.githubusercontent.com/artu-ai/flow/main/install.sh | bash

Or with npm directly:

npm install -g @artu-ai/flow

Or from within Claude Code:

/dashboard:setup

Requirements

• Node.js 18+
• Tailscale (optional, for remote access via flow expose)

How It Works

Flow runs a daemon process (~/.flow/daemon.sock) that manages one dashboard server per project. Each server runs on a separate port (starting at 3420) and is scoped to a project's git root via the PROJECT_ROOT environment variable.

flow open          →  daemon auto-starts  →  spawns server on :3420  →  opens browser
flow open /other   →  (daemon running)    →  spawns server on :3421  →  opens browser
flow list          →  shows both projects
flow stop          →  stops current project's server
flow shutdown      →  stops all servers + daemon

Global config (Linear API key, completion settings) is stored at ~/.flow/config.json and shared across all projects.

CLI

flow open [path]       Start/open a project dashboard (default: cwd)
flow list              List running dashboards
flow stop [path]       Stop a project dashboard (default: cwd)
flow stop-all          Stop all dashboards
flow shutdown          Stop daemon and all dashboards
flow expose [path]     Expose via Tailscale Serve
flow unexpose          Remove Tailscale exposure
flow --version         Show version

Plugins

Flow ships with two Claude Code plugins. Load them via the marketplace or with --plugin-dir:

claude --plugin-dir ./plugins/flow
claude --plugin-dir ./plugins/dashboard

Dashboard

Command	Description
/dashboard/setup	Install Flow and dependencies (Node.js check, npm, Tailscale)
/dashboard/open [path]	Start the dashboard server for a project
/dashboard/stop	Stop the dashboard server
/dashboard/status	List running dashboards
/dashboard/expose	Expose dashboard via Tailscale Serve for remote access
/dashboard/unexpose	Remove Tailscale exposure

Features

• File browser — Sidebar with lazy-loading directory tree, gitignore-aware
• Monaco editor — Syntax highlighting, Cmd+S save, AI inline completions (Ollama / Claude)
• Diff viewer — Side-by-side diff for changed files
• Terminal — xterm.js with PTY, opens in selected worktree
• Worktree tabs — Switch between worktrees from the navbar
• Lint & format — Biome, ESLint, Ruff integration
• Linear integration — View assigned issues, create worktrees from issues
• Remote access — Expose via Tailscale for access from other devices

Flow

Linear + GitHub workflow automation. Supports parallel development using git worktrees.

Command	Description
/flow:checkout [issue-id]	Create a worktree and branch for a Linear issue
/flow:commit [issue-id]	Commit, create draft PR, comment on Linear issue
/flow:commit-leftovers	Commit remaining unrelated changes
/flow:create-issue	Create a new Linear issue
/flow:done	Complete issue after PR merge, clean up worktree
/flow:draft	Convert PR back to draft
/flow:ready	Mark PR as ready for review
/flow:cancel	Cancel work, close PR, clean up worktree
/flow:my-issues	List assigned Linear issues
/flow:next-issue	Pick up next prioritized issue
/flow:progress	Show current issue and PR status
/flow:continue	Resume work on an in-progress issue
/flow:sync	Sync branch with main
/flow:clean	Clean up stale branches and worktrees
/flow:standup	Generate standup summary
/flow:update	Post progress update to issue

Skills

Automatically invoked by Claude when relevant:

Skill	Triggers
issue-context	"the issue", "the ticket", "requirements", "what am I working on"
pr-context	"the PR", "CI status", "checks", "reviews"

Requirements

• GitHub CLI (gh) installed and authenticated
• Linear MCP server configured

Development

npm install
npm run dev        # SvelteKit dev server with HMR on :3420
npm run build      # Production build
npm start          # Run production server

To test the daemon locally:

node cli.js open --no-browser
node cli.js list
node cli.js stop