Getting started

This takes about five minutes: install, connect a model, run a first task.

1. Install

macOS and Linux:

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

Windows (PowerShell):

irm https://raw.githubusercontent.com/huynvic/albertcode-swe-agent/main/installer/install.ps1 | iex

The installer shows what it found and what it would do, then asks Proceed? [Y/N]. Nothing changes before you answer. When it finishes, open a new terminal so it picks up the albertcode command. Installation has the details.

2. Start AlbertCode in a repository

cd your-project
albertcode

AlbertCode shows the repository it is working on and the model it will use. The first time, it starts a small local service in the background, which keeps running between sessions. albertcode stop stops it.

For a browser interface instead, run albertcode --ui.

3. Connect a model

The first time, with no model connected, AlbertCode opens the connect step for you:

1. Pick a provider, then enter its key, or the address of a model running on your machine.
2. AlbertCode checks the key or address works before saving it.
3. Choose a model from the list that opens next.

Skipped it? Run /connect at any time, and /model to change models. Models lists what is supported.

4. Ask for a change

Type what you want done:

› The /login endpoint returns 500 when the password is empty. Find out why, fix it,
  and add a test.

AlbertCode reads the repository and comes back with a plan: what it will change, which files it expects to touch, how it will test the change, and how risky it is.

5. Approve the plan

Read the plan. Approve it to start the work, or reject it and say what you want instead. Nothing has been written yet.

6. Review the result

AlbertCode makes the change in an isolated copy of your repository, runs your tests and checks, and reviews the change. It then shows you the diff and what passed. Your own files are still untouched.

7. Accept, or discard

Accept to apply the change to your repository, or discard it. If you edited the same files while it worked, acceptance is refused rather than overwriting your edits.

Commit the accepted change with Git as you normally would. Git is also how you undo one.

Next

• How AlbertCode works: the ideas behind every page.
• Chatting with Albert: modes, approvals, sessions and attachments.
• Terminal, Browser interface and VS Code: every command.
• Extending: your own commands, agents, tools, plugins and MCP servers.
• All the documentation.