Spur

A mobile-friendly dashboard for software engineers that brings all your AI agents into one place — manage multitasking workflows from any device.

Local daemon + CLI orchestrator for AI coding agents.

• Spawns agents (claude / codex / cursor / opencode) in tmux sessions, using either an owned git worktree or the shared project path
• Watches sources (cron, github, gitlab, sentry, service, telegram) and routes events to triggers
• Triggers either spawn a new session or send a message into an existing one

Install

Coding-agent installs must use npm. Hand this to your coding agent:

Fetch https://raw.githubusercontent.com/ashugaev/spur/main/docs/install-from-npm.md with curl — read the
raw file, never a summary of it — then install and run Spur on this machine end to end, following the
guide. Do the steps yourself; don't ask me to run what you can run.

Everything — ports, Tailscale, verification — is in that guide. Tested on Ubuntu; elsewhere, expect to sort out host differences yourself.

By hand: docs/install-from-npm.md (npm) · docs/install-from-source.md (source, contributors/maintainers only; not for agents unless explicitly requested).

Docs

• docs/commands.md — CLI reference (spawn, wake, list, service, sidecars)
• docs/daemon-api.md — daemon HTTP routes
• docs/configuration.md — config layers, fields, sources/triggers, events
• docs/dashboard-search.md — dashboard search fields and desk behavior
• docs/web-terminal.md — recent web links in terminal output
• docs/claude-accounts.md — claude account rotation and per-session credential switch
• docs/voice.md — voice input setup
• docs/https-tailscale.md — HTTPS on the tailnet hostname (required for voice)
• docs/install-from-npm.md — install from npm (official)
• docs/install-from-source.md — install from source (contributors only)
• SETUP.md — contributor bootstrap and local web UI development
• CONTRIBUTING.md — PR scope and required checks
• TROUBLESHOOTING.md — fixes for common local failures
• SECURITY.md — reporting and network posture
• AGENTS.md — repo-specific implementation rules
• docs/design-workflow.md — Claude Design pre-implementation gate

Repo layout

• v2/ — Spur daemon, CLI, automation runtime, tests, config example
• packages/web/ — Next.js UI over the Spur daemon API
• scripts/setup.sh — contributor bootstrap
• tests/integration/ — onboarding smoke environment
• spur.yaml — repo-local project config for this checkout

License

Apache License 2.0. See NOTICE.