Local development
Run the website, API, workers, and previews around an agent's work.
A code change is difficult to judge if the app is not running. Save each component's run command, watch its logs and ports, and open the result beside the agent session. A background worker such as Trigger.dev can run as a configured command. Canopy manages those local processes; it does not replace your project's runtime or hosting.
Open this topic's article index for AI assistants →
Why won’t my phone open my local dev site?
Use the computer's LAN address, check the dev server's bind host and port, then trace API calls and HTTPS-only browser features on the phone.
Read → Guide / 2026-09-28How do I run Supabase locally with my AI-built app?
Start the Supabase CLI stack, connect the local app to its actual project URL and keys, and verify a test record stays off production.
Read → Guide / 2026-09-28Why did my Trigger.dev task send two emails?
Trace duplicate email through task run IDs, retry attempts, app triggers, and provider events before replaying or changing idempotency settings.
Read → Guide / 2026-09-28How do I test a Trigger.dev email task without emailing real users?
Trace one local signup through the Development worker and a test email destination before an agent runs a side-effecting task.
Read → Guide / 2026-09-28Why does my AI-built app lose data when I refresh?
Find whether a Save button updates only UI state, browser storage, or a real backend, then test the persistence the product actually needs.
Read → Guide / 2026-09-28Is my local AI-built app using the production database?
Trace the browser, API, worker, and database targets before an agent tests writes or migrations in a locally running app.
Read → Guide / 2026-09-28How do I keep a coding agent in the right app in a monorepo?
Identify the owning package, shared dependencies, checkout, and run command before an agent edits one feature in a multi-app repository.
Read → Guide / 2026-09-28Why did my coding agent change the lockfile for a small fix?
Trace an unexpected package-lock or pnpm-lock diff to its command and dependency decision, then review and reproduce the PR safely.
Read → Guide / 2026-09-28Trigger.dev runs stuck in dev? Check for a second agent worker
Trace a queued local task across the app, Trigger.dev project, dashboard, and worker processes when two agent worktrees are open.
Read → Guide / 2026-09-28Can two coding agents use the same development database?
Find which database each agent worktree really uses, choose shared or isolated state deliberately, and review competing migrations before integration.
Read → Guide / 2026-09-28How do I turn a Figma design into a running page with a coding agent?
Hand an agent one frame, states, assets, and component constraints; run the page in Canopy and review behavior, visuals, and the final diff.
Read → Guide / 2026-09-28Why do my agent tests pass locally but fail in GitHub Actions?
Compare the exact PR commit, failing CI step, runner, install, environment, and test command before changing code or rerunning a job.
Read → Guide / 2026-09-28Why does my browser show the old app after my coding agent changed the code?
Trace a stale local preview through the checkout, running server, actual port, hot reload, browser cache, and data request before asking an agent to edit again.
Read → Guide / 2026-09-28Vercel says the Git author must be a team member: what do I check?
Diagnose a Vercel PR preview blocked before its build by checking the commit author, connected Git account, project team, and access request.
Read → Guide / 2026-09-28AI-built app works locally but fails on Vercel Preview
Find the first difference between a working Canopy run and a broken Vercel Preview: commit, build, environment, runtime request, or backend target.
Read → Guide / 2026-09-28Can I launch my AI-built app? A founder's decision sheet
A go-or-hold review for an AI-built web app: running behavior, access, data, payments, recovery, and the exact release version.
Read → Guide / 2026-09-28Review an AI-generated Supabase migration before deployment
Check the target project, schema diff, existing data, RLS, staging result, and actual restore option before an agent-written migration reaches production.
Read → Guide / 2026-09-28Review an AI-built Stripe Checkout before taking payments
A founder's test-mode review of Checkout, signed webhooks, delayed payments, duplicate events, and fulfillment before launch.
Read → Guide / 2026-09-28How do I find the command that runs an AI-built app?
A beginner workflow for finding the project directory, runtime, run script, local URL, and first useful error before asking an agent to fix setup.
Read → Guide / 2026-09-28How to inspect an open-source AI IDE before installing it
A repeatable Canopy release check: match installer to tag, verify the asset digest, read source and license boundaries, and test what connects to the network.
Read → Guide / 2026-09-28Can a noncoder build software with AI coding agents?
A realistic first-project path for noncoders: choose a bounded task, run the result, review observable behavior, and know when a developer must check the change.
Read → Guide / 2026-09-28Debug an agent-built page using the browser console and network log
Collect the exact failing action, console message, request status, service log, and checkout before asking an agent to fix a broken preview.
Read → Guide / 2026-09-28How do I ask a coding agent for a demo I can inspect?
A founder-friendly request and acceptance checklist that turns an agent's 'done' message into a running page, observable behavior, and a reviewable diff.
Read → Guide / 2026-09-28How do I run a Trigger.dev worker beside my app in Canopy?
Set up Trigger.dev once, save its dev command beside the website and API, run a dashboard test, and debug the right process.
Read → Use case / 2026-09-28What happens to a coding agent when you close Canopy?
Distinguish a closed tab, hidden project, hibernation, app exit, and CLI conversation resume before relying on a session overnight.
Read → Blog / 2026-09-28Why an AI coding workspace still needs a real terminal
What a PTY preserves for interactive coding CLIs, what Canopy adds around it, and a quick test for comparing agent workspaces.
Read → Use case / 2026-09-28Find the old agent session, then resume the right project
Recover a past decision from search, verify the branch and PR, restart local services, and resume only the session that still helps.
Read → Guide / 2026-09-28Why a new agent worktree cannot build: env files and dependencies
Diagnose missing .env files, local packages, Python environments, ports, and shared services before blaming the coding agent.
Read → Guide / 2026-09-28How to give a coding agent useful visual feedback
Turn a vague 'this looks wrong' into a page, viewport, element, expected behavior, and screenshot an agent can act on.
Read → Guide / 2026-09-28How do I test an AI-built UI before merging it?
Review the running page across viewport sizes, interaction states, console and network errors, keyboard use, and the latest PR diff.
Read → Use case / 2026-09-28How do I stop two agent worktrees from using the same port?
Keep each branch's local preview distinct, identify the process behind a URL, and compare the right running app with the right diff.
Read → Guide / 2026-09-28The coding agent says done, but the app is still broken
A recovery workflow: reproduce the failure, inspect local services and logs, point the agent at evidence, and verify the new diff.
Read → Use case / 2026-09-28Terminal, tmux, or Canopy for coding agents?
Compare the actual jobs: running a CLI, keeping sessions alive, isolating edits, starting services, and reviewing agent work.
Read → Use case / 2026-09-27Resume a local coding agent from your phone
Use Canopy Remote to inspect a running project, reconnect after a phone disconnect, and steer the right agent without repeating a task.
Read → Use case / 2026-09-27How do I start my website, API, and worker with one click?
Run a downloadable three-process project: save its commands, watch a worker change the API count, inspect the preview, and verify the agent's edit.
Read → Guide / 2026-09-27How to set up Canopy and run your first AI coding agent
Install an agent CLI, open a project in Canopy, run the app, and review your first change. Includes a downloadable practice project.
Read → Guide / 2026-09-27Run a website, API, and background worker in one workspace
Configure project run commands once, then start, inspect, and restart your local development stack from Canopy.
Read → Use case / 2026-09-28Can Canopy work offline with a local coding agent?
Test local files, Git, services, Preview, search, and a preinstalled CLI against the separate requirement for a local model endpoint.
Read → Guide / 2026-09-28Why won’t my dev server start in Canopy?
Trace a failed website, API, or worker launch through its checkout, command, first error, port, dependency, and observed URL.
Read → Guide / 2026-09-28Coding agent stuck or waiting for input? Check the live session
Distinguish a pending decision, active tool, running dev server, completed turn, and failed agent before interrupting or restarting.
Read → Use case / 2026-09-28Canopy vs Superset for parallel coding agents
Compare two local agent workspaces across worktrees, persistent processes, app runs, browser preview, PR review, Remote, and license terms.
Read → Use case / 2026-09-28Canopy vs Replit Agent for building an app
Compare a hosted AI app builder with a local multi-CLI workspace across first setup, parallel tasks, preview, GitHub, deployment, team access, and usage.
Read → Guide / 2026-09-28Work on a Lovable app locally in Canopy without losing Git sync
A branch, environment, preview, and publishing checklist for using local coding agents on a Lovable project connected to GitHub.
Read → Guide / 2026-09-28Keep building a Bolt app with local coding agents in Canopy
Connect Bolt to GitHub, isolate an agent change, check the app's backend and run commands, merge in GitHub, and verify Bolt and the live site.
Read → Guide / 2026-09-28v0 not showing your local agent's GitHub changes? Check the branches
Trace a local Canopy agent change through GitHub, v0's base and working branches, Pull Changes, preview deployments, and production permissions.
Read → Use case / 2026-09-28Canopy Remote, Claude Code, Copilot CLI, or SSH from your phone?
Choose a remote coding-agent workflow by host state, CLI coverage, project evidence, access rules, and what you can actually verify on a phone.
Read → Guide / 2026-09-28Run OpenCode with a local Ollama model in Canopy
Set up a local model route, account for OpenCode V1 and V2 differences, verify context and tool use, then test an offline coding task in Canopy.
Read →