DEEN

DocsReference

CLI commands

Everything alran does from the shell.

Which alran commands are there?

CommandWhat it does
alran [prompt]Open the terminal UI in the current folder, optionally with a first task
alran exec [prompt]Run one task without the TUI (Headless and CI)
alran init [dir]Study the codebase and write AGENTS.md
alran auth login · status · switch-company · logoutYour Ottili account (Sign in)
alran config company · project · modelThe company, project and default model
alran modelsModels, prices and whether you can use them
alran usageCredit left and this month’s spend per model
alran billingPlan, payment method, last invoice
alran provider list · add · remove · test · useYour own providers and keys (Your own provider)
alran plugin search · info · install · update · remove · marketplacePlugin Store (Plugins)
alran skills list · search · info · install · update · removeSkill Library (Plugins)
alran acpRun as an Agent Client Protocol server (Node.js and ACP)
alran updateCheck for and install an update
alran telemetryInspect anonymous usage reporting
alran mascotMeet the Alran mascot

Options of alran

OptionWhat it does
-m, --model <provider/model>The model for this session only
-c, --continueContinue the latest session in this folder
--session [id]Open a session by id, or browse sessions
--mode <standard|lightweight>Lightweight: no tools, no files
--tui-mode <regular|fullscreen>The TUI layout
--append-system-prompt[-file]Add to the agent’s prompt for this process
--system-prompt[-file]Replace the agent’s identity section
-V, --versionThe version

Every command has --help, for example alran exec --help. Account commands accept --json.

Common questions

Which alran commands are there?

Alran has commands to open the terminal UI (alran), to run one task without the TUI (alran exec) and to write AGENTS.md (alran init), plus alran auth, alran config, alran models, alran usage, alran billing, alran provider, alran plugin, alran skills, alran acp, alran update, alran telemetry and alran mascot. Every command understands --help, for example alran exec --help, and the account commands accept --json.

How do I use another model for one session only?

The option -m, --model sets the model for this session only. The alran config command sets the company, the project and the default model.

How do I continue the latest session in this folder?

The option -c, --continue continues the latest session in this folder. The option --session opens a session by id, or lets you browse sessions.