Picasso Docs
The coding agent for the terminal and the Mac.
Install Picasso, connect a provider, and learn the terminal app and Picasso for Mac: memory, goals, history import, and what Picasso keeps on your machine.
Get started
Code Freely. Code Beautifully.
QuickstartInstall Picasso, add a model, and take one interactive turn in a couple of minutes. Picasso comes two ways that share the same settings, threads, themes and memory: Picasso for Mac
What Picasso puts on your MacEverything Picasso for Mac and the picasso command line install, run, read, write and talk to, and how to remove all of it. It is written from the code and checked against it by te
FAQYes. Picasso is funded by a labelled sponsor line, and it has a free model (picasso provider use picasso-free). If you bring your own API key, your provider bills you directly for
ChangelogEvery user-visible change to Picasso for Mac and the Picasso CLI/TUI (@picassohq/cli), newest first. Mac versions are the signed app releases; CLI/TUI changes ship from the same so
Guides
The terminal user interface: picasso with no command (or picasso tui) opens it. This page is the functional reference for what ships on main: how the screen is laid out, how you ta
Keyboard ShortcutsThis document is generated from packages/tui/src/keyboard.ts.
ProvidersPicasso runs every model call through one of two credential modes. Subscription sign-in is not available at launch ([17](17-subscription-passthrough.md) is post-launch).
Memory QuickstartInitialize project memory and run the first recall query.
15 - MemoryThe persistent memory layer. The agent does not start cold every session. It remembers the codebase's architecture, the developer's coding style, and the decisions that were made a
/goal QuickstartRun a bounded long-horizon goal in under five minutes.
GoalsThe /goal long-horizon autonomous mode. Provider-agnostic. The agent runs until a completion contract is satisfied — minutes, hours, or days — planning, acting, testing, and self-c
Goal Contract ReferenceA goal contract (@picasso/goals GoalContract) defines what Picasso should finish, where it may work, how much budget it may spend, and — critically — how completion is judged by ma
History importPicasso can bring in past sessions from Claude Code, Codex and OpenCode as read-only threads. The code is packages/sessions/src/history-import (@picasso/sessions/history-import), s
Remote engines (cloud fleet)Picasso can run threads on more than one engine: the bundled engine on this Mac plus remote engines you start yourself on another host — a workspace VM, a build box, a devcontainer
Auth and AccountsA Picasso account is needed only for managed inference, memory sync, cloud sessions and the account dashboard at https://picassohq.com/account. Bring-your-own-key runs work without
Migration GuideMove from existing coding agents to Picasso without losing workflow shape. Signing in with a Claude or ChatGPT subscription is not available in this release; use an API key, a rout
How Picasso works
Extend Picasso
For contributors
Reference