> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pre.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Agents: start with https://docs.pre.dev/agents.md, which has complete recipes, plan access, polling rules, errors and limits.
> Authenticate with the workspace API key (pdk_…) from Integrations → Built-in, sent as Authorization: Bearer <key>.
> REST API: https://api.pre.dev (OpenAPI: https://docs.pre.dev/api-reference/openapi.json). AI Gateway: https://api.pre.dev/v1, OpenAI-compatible (OpenAPI: https://docs.pre.dev/api-reference/ai-gateway.openapi.json).
> pre.dev MCP server: https://api.pre.dev/mcp. Search these docs over MCP at https://docs.pre.dev/mcp.

# Coding Agent quickstart

> Create a project, make a change, and review the result.

Build a small issue board, add a useful filter, and inspect the result. You can follow the same workflow in a new project or an existing repository.

## Before you start

You need a [pre.dev account](https://pre.dev) and available [credits](/coding-agent/plans-and-credits). To work on existing code, have access to the GitHub repository you want to import.

## Build your first change

<Steps>
  <Step title="Create a project">
    Sign in at [pre.dev](https://pre.dev) and describe what you want to build, or [import a GitHub repository](/coding-agent/projects/importing-repos).

    ```text theme={null}
    Build an issue tracker for a small design team.
    Include projects, assignees, due dates, and a status board.
    Start with a working board using sample data.
    ```
  </Step>

  <Step title="Let the agent choose the approach">
    The agent chooses the next step itself: it can build a small change directly or plan a larger one first. To work on the requirements and architecture first, ask for a plan in your message.

    For an existing app, include the expected behavior, the current problem, and any files or constraints you already know.
  </Step>

  <Step title="Connect what the project needs">
    Open `/integrations` for **Project setup**. Choose the relevant connection account, enable skills or MCP servers, and fill required values under **API Keys**. AI, payments, and sign-in are [already built in](/coding-agent/built-in). Use [environment variables](/coding-agent/integrations/env-vars) for other secrets and configuration.
  </Step>

  <Step title="Build a concrete change">
    Ask the agent to implement the first useful piece. For a dedicated sprint, use:

    ```text theme={null}
    /sprint add filtering by assignee and status, with an empty state
    ```

    A useful result lets you combine both filters, shows only matching issues, and explains when no issues match. Include these criteria in your request so you can check them in the preview.

    Follow the active session and its progress. Additional web sessions may require a connected GitHub repository.
  </Step>

  <Step title="Review and ship">
    Inspect the code changes, the verification result, and the preview. Test your acceptance criteria, then request any corrections. When the app is ready, choose **Publish** in the header to put it at its permanent address.

    For code in GitHub, the session's **Merge into Main** action can create a pull request and merge it automatically when clean. Use a review-first request if you want a PR left open.
  </Step>
</Steps>

## Check the result

Select an assignee and a status, then clear each filter. Try a combination with no matching issues. Compare that behavior with the code changes and the agent's verification report.

| If you need to… | Continue with |
| - | - |
| Find code, plans, or the active session | [The workspace](/coding-agent/workspace) |
| Understand which checks ran | [Verification](/coding-agent/building/acceptance-criteria) |
| Open a preview or troubleshoot a missing one | [Preview and hosting](/coding-agent/building/preview-and-hosting) |
| Review and merge the code | [Pull requests](/coding-agent/building/pull-requests) |
| Put the app at a permanent address | [Publish](/coding-agent/building/publish) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.