Full reference16 guidesalbert-mini

mini-AlbertCode SWE Agent documentation

Every command, page, key and setting of mini-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/mini-albertcode-swe-agent/main/installer/install.sh | sh

Start with Getting started

Everything you need to install, use and run mini-AlbertCode SWE Agent: every command, key and gate, with examples. mini-AlbertCode is a coding agent you run on your own machine, with two interfaces, a terminal and a browser workspace, on one local service, and the AlbertCode engine's two human gates.

Start here

Getting started: install, connect a model, and finish a first task in about five minutes.
How mini-AlbertCode works: the service and its two interfaces, asking and changing, the modes, the life of a governed change, sessions and tasks, and what is kept where.
Using mini-AlbertCode: the short version of everything, with links.

Using mini-AlbertCode

Guide	What's in it
The terminal	`albert-mini`: the prompt, every key, slash command and list, gates, the sidebar, themes
The browser	`albert-mini web`: signing in, the workspace (navigator, gate track, console, inspector), every shortcut, settings
Modes and approvals	Governed, Direct and Ask only; the two human gates and every answer; from scripts
Sessions	Sessions shared by both interfaces: opening, renaming, pinning, forking, exporting
Models	Connecting a provider, choosing and testing a model, local models

Extending

Guide	What's in it
Custom commands and agents	Prompts you call by name, and roles that narrow what a task may do
MCP servers	Outside tools: adding servers, signing in, the connector catalogue, importing

Reference

Guide	What's in it
Commands	Every `albert-mini` command and option, with examples and exit codes
Installation	Options, updating, uninstalling, requirements, files and folders
Security model	The local service, its access token, where keys are kept, what leaves your machine
Troubleshooting	Fixes for installing, starting, models and tasks
FAQ	Short answers
Glossary	Every term, in one place

Find a command

I want to…	Terminal	Browser
Ask a question	Type it	Type it
Make a change with approvals	`/plan …`, or the Governed mode	`/plan …`, or Governed
Change files directly	`/do …`	`/do …`, or Direct
Connect a model	`/connect`	Settings › Connect a provider…
Choose a model	`/model`, or `Ctrl` `X` `M`	The model menu under the box, or `Alt` `M`
Open or clone a project	Start `albert-mini` in its folder	Project › Open a folder… or Clone a repository…
Commit, pull, push, branches	Git, in a terminal	The Git menu, or the branch under the box
Work in a second checkout	`git worktree add`	Project › Worktrees…
Start a new session	`/new`	`Alt` `N`
See every session	`/sessions`, or `Ctrl` `X` `L`	`Alt` `B`
See the change	`/diff`, or `Ctrl` `X` `D`	`Alt` `P`, Changes
Give it a file or screenshot	`/attach <path>`	The + beside the box
Open the session in the other interface	`/web`	`albert-mini -s <id>` in a terminal
Add an MCP server	`/mcp`	MCP servers, from `Ctrl` `K`
Every command	`/help`, or `Ctrl` `P`	`Ctrl` `K`
Search this guide	`/docs <words>`, or `albert-mini docs <words>`	Help › Search the guide…, or `/docs`
Show or hide the agent's steps	`/details`, or `Ctrl` `X` `O`	`Alt` `S`

Getting help

Search this guide where you work: Help in the browser, /docs <words> in the terminal, or albert-mini docs <words> in a shell. It comes with mini-AlbertCode, so it works offline.
Troubleshooting has the fixes for common problems, and albert-mini doctor checks your installation.
Report a bug in Issues, with albert-mini --version and your operating system. Never include keys, tokens or private code.

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