Run your first agent

Start a lane-scoped chat, watch the agent work, and review the result.

Start with Agent Chat. It is the fastest way to learn ADE because it shows the full loop: prompt, tool calls, file changes, terminal output, review, and commit.

Start the chat

1. Select the lane

   Open the lane you created for this task.

2. Open Work or Chat

   Start a new chat session in that lane. The session header should show the lane name.

3. Choose a provider

   Use the default provider or pick another verified provider from the model selector.

4. Send a narrow task

   Ask for one contained change. Avoid broad prompts like “clean up the whole app” for your first run.

5. Watch tool calls

   The transcript shows reads, edits, shell commands, and test output as the agent works.

6. Review the diff

   Open Files, inspect every changed file, run tests if needed, then commit.

First prompt

Add a GET /health endpoint that returns { "status": "ok" } and add one test for it.

If the agent gets stuck

• Press Stop and ask for a shorter plan.
• Paste the exact test or build error back into the chat.
• Switch to a stronger model for the session.
• Keep the task inside the lane; do not move it to your primary checkout.

After the task

Files

Review and edit the changed files.

Pull requests

Create a PR once the lane is ready.