Documentation
Guides for getting the most out of DevSpec — start with the essentials, then dig into any feature. New here? See what DevSpec does.
Getting started
What DevSpec is, how to set it up, and where to go when you need help.
What is DevSpecA plain-English guide to what DevSpec is, all the parts that make it up, and how they fit together.Why DevSpecWhy we built DevSpec: a practical way for real teams to build software with AI agents, keep decisions intact, and stay in control.QuickstartGo from signing up to a first useful answer from Dev and a first piece of work handed to your agent.How work flows through DevSpecFollow a change from the conversation where it's agreed, through your agent and your deploy, to the check that it works.TroubleshootingFixes for the problems people most often hit in DevSpec, from a missing agent to a limit message from Dev.Frequently asked questionsShort answers to the questions people ask in their first week with DevSpec, with links to the full guides.Getting helpWhere to get help with DevSpec: the free help assistant, Dev in a session, the Help page, and the contact page when you can't sign in.
Plan and discuss
Talk work through with your team and Dev, and keep track of where the project is heading.
Project OverviewSee what needs you in a project, get back into your conversations, keep private notes and check how the work is going, all from one page.SessionsTalk work through with your team, Dev and your agents in one shared room, and keep what you decide.Dev, your assistant in sessionsWhat Dev knows, what it can and can't do for you, how it records decisions, how it looks things up on the web, and how to set its effort and reply style.VoiceSpeak your messages instead of typing, have messages read aloud, and choose the voice, speed and privacy settings that suit you.GoalsWrite down where the project is heading, set goals, link work to them, and watch progress follow the work automatically.
Build with agents
Turn decisions into tracked work, hand it to your agent, and check what it built.
TasksTrack each piece of work from the conversation that agreed it to the check that it works: why it matters, how you'll know it's done, and where it stands.Connect your agentConnect Pi, Claude Code, or Antigravity CLI on your own machine to DevSpec, so it works from your project's tasks, decisions and documents and records what it ships.Working with your agentsSee your connected agents, hand them tasks, bring them into sessions, choose who can instruct them, and set how their work lands in your repository.
Ship and track progress
Follow work from commit to deploy, and see how the project is moving.
DeliveryConnect Vercel or Coolify so every deploy shows up in DevSpec, linked to the work it shipped, with build logs and a diagnosis when one fails.Commit trackingHow DevSpec links each commit to its task, and writes up the commits that landed without one.AnalyticsSee how a project is moving: how long work waits, where the effort goes, how work starts and how the project's knowledge is holding up.ChangelogSee what your project shipped, newest first, find a shipped change, and open it to see everything about it.AutomationsSave a job once, such as a dependency sweep or a branch clean-up, and run it again on your own agent whenever you like or on a schedule.
Project knowledge
What your team has decided and written down, and how it stays accurate.
MemoriesKeep the decisions, conventions and risks your team has settled, so every later session and agent can find them.ReviewAnswer changes that need your OK, accept proposals, and keep project knowledge accurate.Documents and artifactsUpload the files your team works from, and keep the plans, guides and decision records Dev and your agents write for you.TagsKeep one shared set of tags across your project's work and knowledge, and tidy it so related things stay grouped together.Rules and instructionsTell Dev and your agents how to work on your project, and how you like to be answered.
Projects and your stack
Set up a project and connect your code, database and logs.
ProjectsCreate a project, set it up, add your team, and manage its settings.Repositories and GitHubGive DevSpec access to GitHub, add repositories to a project, and keep them up to date.Code indexingWhat DevSpec indexes in your repositories, how it stays current, and what to do when indexing fails.Database and migrationsConnect your Supabase database so Dev knows your real schema, and track which migrations have been applied.LogsConnect Axiom so Dev can search your runtime logs and errors when you ask about them.
Account, team and billing
Your settings, notifications, organizations and roles, and how billing works.
Your settingsYour profile and theme, how you sign in, how you're answered, your agents, your notifications, your privacy and your organizations.Notifications and messagesFind what needs you with the notification bell and the Notifications page, choose what reaches your email, and send private messages to the people you work with.Organizations, members and rolesCreate an organization, invite your team, understand organization and project roles, and hand over, export or delete an organization.Billing, usage and limitsHow DevSpec charges, what things cost, how to add funds and set limits, and what happens when the balance or a limit runs out.