First project

Open a folder, explore safely, pick a small task, and review every change.

The intended first hour is ordinary engineering, not a rewrite. Open a real project folder and learn the surfaces before you grant broad permissions.

Open and orient

  • Open a folder as the workspace root
  • Skim the explorer tree and locate tests, configs, and entry points
  • Check SCM status so you know the starting dirty state
  • Run the tests or checks you already trust

Pick a small task

Good first requests are bounded: tighten a redirect, rename a symbol across two files, add a missing test, or fix a clear lint. Avoid “rewrite the application” until you trust reviews and permissions.

Choose a mode

  • Ask — explore architecture and ask questions without writing files
  • Agent — implement the small change with tools
  • Plan — outline steps and trade-offs before edits when the task is ambiguous

Permissions

Set permissions deliberately before shell or git tools run:

  • Ask — prompt you for sensitive actions
  • Allow safe — allow lower-risk operations without stopping every time
  • Allow all — broadest automation; use only when you are watching closely

Review and apply

Stay for the review. Inspect diffs in SCM and the agent transcript. Auto-apply of agent edits defaults to on; turn it off if you want an explicit apply step for every patch.

Extra folders

Attach additional roots with @extra/name style references when the agent needs code outside the primary workspace folder. Keep secrets and huge generated trees out of those attachments when possible.