Skip to content

quickstart.md

Latest commit

 

History

History
36 lines (28 loc) · 1.49 KB

quickstart.md

File metadata and controls

36 lines (28 loc) · 1.49 KB
Raw
title Quickstart
description Open a project, pick a model, and send a first prompt you can verify.

Quickstart

Fastest path

  1. Install Copse and launch it.
  2. Open a project folder — a Git checkout you are happy to let the agent read.
  3. Connect a model. If you are running from source and want the development mock instead, restart with COPSE_PANEL_MOCK_LLM=1 pnpm run dev.
  4. Trust the project when Copse asks. An untrusted checkout does not get auto-run or project MCP servers.
  5. Type a concrete request, for example “explain how authentication works” or “show me the failing tests.”

You should see your message in the thread, then either a reply or a tool card (read, search, or a command). That is success.

If the composer stays empty or the model picker has no entries, go to Connect a model. If a dialog interrupts a command you expected to run, read Approvals.

What “in control” looks like

  • File edits appear in the Changes pane. Safe worktree edits land directly with a backup; edits that cannot be applied safely wait for your approval.
  • Commands that leave the project sandbox ask first, unless they match a recognised auto-approval shape.
  • The integrated Shells tab is your terminal. It is not the agent’s run_shell tool and it is not sandboxed. That is intentional.

Next: Approvals: what the dialog is asking.