Repository navigation
First Run and the Wizard
The first launch shows a welcome page with the PiCode mark and a short setup flow — all inside the editor, with no terminal step required to reach a working agent.
Every step can be skipped, and each choice is an ordinary setting you can change later.
- Sign in. The PiCode Account, used for cloud sync. Skip it and everything keeps working locally.
-
Choose the pi.
-
Built-in pi (recommended): installed by PiCode, with its
profile inside PiCode's
data/. Updated from the editor — nobody installs or configures anything by hand. - Your installed pi: connect to a pi that already lives on your machine, to use its data where it is. PiCode never writes to it.
-
Built-in pi (recommended): installed by PiCode, with its
profile inside PiCode's
- Provider & model. Pick a subscription (ChatGPT, Claude, Copilot, Grok, Kimi, Meta, OpenRouter…) or declare a compatible endpoint with an API key, then choose the default model. The OAuth flows are Pi's own, shown as editor dialogs.
- Packages (optional). Browse what is installed and the gallery, and install what you want.
- Theme. A gallery with real previews: hover to try one on, click to keep it.
Importing an existing external profile is offered with counts — what would come in: packages, connections, skills and conversations. Credential import is unchecked by default and asks for its own confirmation.
The stock VSCodium first-run noise — the Start page, recent announcements, the Copilot-era banners — is gone. If you skip the flow, run PiCode: Set up PiCode to bring it back.
- The editor's Chat is the surface. Type
@piand ask. - Pi's settings live under the editor's settings tree, in the product's own nodes. There is no separate PiCode settings page, by design.
- Everything the wizard wrote lives in
data/. That folder is what cloud sync will upload as one unit.
The wizard ships and works through its rounds. The pieces that read state back from the core — skill and agent discovery, the status view — are still closing. See Roadmap and Known State.
Next: Pi Inside · Gentle AI and ODD