DocsGet started
Quickstart
From install to a finished task in five steps.
1. Install
curl -fsSL https://alran.dev/install.sh | bashOther ways, updates and uninstalling: Install.
2. Sign in
alran auth login # opens the Ottili sign-in in your browser
alran auth status # who, which company, which projectNew accounts get welcome credit for Ottili Werk 1.1. Over SSH you confirm a code in any browser instead. More in Sign in and accounts.
3. Hand over a task
Open the project and start Alran. Say what you need in one sentence.
cd ~/code/my-project
alranOr give the task right away:
alran "Find the failing test, fix the code and run the tests."Alran reads the project, shows a to-do list and works through it. Steps with effects outside your workspace wait for your OK. Press Shift+Tab before you send to see only the plan first.
4. Write the project guide
alran init .Alran studies the codebase and writes AGENTS.md: how to build, test and what to watch out for. Every later session reads it first. Edit it like any other file.
5. Pick up where you left off
alran --continue # the latest session in this folder
alran --session # choose from a listInside the terminal UI, /sessions finds earlier sessions and /help lists every command.
Next
- Goal Mode: set a finish line, Alran keeps going until it is met.
- Subagents: split the work across a team of agents.
- Headless and CI: run
alran execin scripts and pipelines. - Models and credit: Werk on your credit, Claude Sonnet 5.5 and Opus 5.5 on your own Anthropic key.
Common questions
How do I get started with Alran Code?
Install Alran Code with the installer script, sign in with alran auth login and then open your project folder and tell Alran in one sentence what you need. Alran reads the project, shows a to-do list and works through it. New accounts get welcome credit for Ottili Werk 1.1.
What does alran init do and what is AGENTS.md?
Run alran init in your project and Alran studies the codebase and writes AGENTS.md. The file holds how to build and test the project and what to watch out for, and every later session reads it first. You can edit it like any other file.
Does Alran Code ask before it does something outside my project?
Yes. Alran shows a to-do list and works through it, but steps with effects outside your workspace wait for your OK. Press Shift+Tab before you send to see only the plan first.