Full reference21 guidesalbertcode

AlbertCode SWE Agent documentation

Every command, page, key and setting of AlbertCode SWE Agent, from its repository's own guide. The same guide ships inside the agent, offline: /docs in the terminal.

Install · macOS and Linux

$curl -fsSL https://raw.githubusercontent.com/huynvic/albertcode-swe-agent/main/installer/install.sh | sh

Start with Getting started

Everything you need to install, use and operate AlbertCode SWE Agent: every command, page and button, with examples.

You can read it inside AlbertCode too, offline: Help → Search the guide… in the browser workspace, /docs in the terminal, or Documentation in VS Code.

Start here

Getting started: install, connect a model, and finish a first task in about five minutes.
How AlbertCode works: the service, the modes, a change's two approvals, tasks, sessions, evidence, and what AlbertCode keeps where.
Chatting with Albert: asking, changing, approving, sessions, chats grouped by topic, attachments.

Using AlbertCode

Guide	What's in it
Using AlbertCode	The short version of everything, with links
Terminal	`albertcode`: the terminal interface and the classic terminal, every option, command and subcommand, scripting, environment variables
Browser interface	The workspace: its menus, the inspector (changes, files, the app, its tests), the terminal, the command palette, every shortcut; and the classic page
VS Code	Installing the extension, the panel, every command and setting
Models	Providers, local models, choosing and testing a model, pace, keys

What your app is made of, and what it must do

Guide	What's in it
Architecture	What a repository is made of, read from its own files
Requirements	What the app must do, as a checklist backed by evidence
Preview and browser tests	Run the app beside the chat, edit it by clicking, test it in a real browser

Control and evidence

Guide	What's in it
Tasks and evidence	The task board, a task's evidence, the evidence ledger, compliance exports, memory, language checks
The contract	`albertcode.contract.toml`: what AlbertCode may do in a repository
Security model	How your keys, code and data are protected

Extending

Guide	What's in it
Extending	Custom commands, custom agents, saved tools and skills
MCP servers	Connectors, adding servers, sign-in, prompts and resources
Plugins	Installing, updating and making plugins; the plugin format

Reference

Guide	What's in it
Installation	Options, updating, uninstalling, requirements
Troubleshooting	Fixes for installing, running, and building and running systems
FAQ	Short answers
Glossary	Every term, in one place

Find a command

I want to…	Terminal	Browser	VS Code
Ask a question	Type it	Type it	Type it
Make a change with approvals	`/plan …`	`/plan …`, or the Governed mode	`/plan …`, or Governed
Change files directly	`/do …`	`/do …`, or Direct	`/do …`, or Direct
Connect a model	`/connect`	Connect a provider	Connect a Provider
Choose a model	`/model`	`Alt` `M`	Choose Model
Start a new conversation	`/new`	`Alt` `N`	+ (New chat)
Give it a file or screenshot	`/attach <path>`	Paste or drop	Paste or drop
See every task	`/tasks`	Tasks	Task History
Read the evidence ledger	`/ledger`	Evidence ledger	Evidence Ledger
Export a change's evidence	`albertcode compliance <task>`	Export evidence
Set the repository's limits	`/contract`	Contract	Show the Contract
Add an MCP server	`/mcp add`, `/connectors`	MCP servers	Add an MCP Server
Make a custom command	`/commands new`	Commands, agents and plugins	Custom Commands
Install a plugin	`/plugins install …`	Plugins	Plugins
Run the app	`/preview`	Run the app	Run App
Every command	`/help`	`Ctrl`/`⌘` `K`	`Ctrl`/`⌘` `Shift` `P` → AlbertCode

Getting help

Troubleshooting has the fixes for common problems.
Ask in Discussions.
Report a bug in Issues, with albertcode --version and your operating system. Never include keys, tokens or private code.

From docs/README.md in huynvic/albertcode-swe-agent at a8cef99 (15 Oct 2026), shown unchanged except for links. AlbertCode SWE Agent documentation, CC BY 4.0. Latest on GitHub.