---
title: "CLI commands · Alran Code Docs"
url: https://alran.dev/en/docs/cli
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Reference

# CLI commands

Everything `alran` does from the shell.

On this page

[Which alran commands are there?](#commands) [Options of alran](#options) [Common questions](#faq)

## Which alran commands are there? {#commands}

| Command | What 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](https://alran.dev/en/docs/headless)) |
| `alran init [dir]` | Study the codebase and write `AGENTS.md` |
| `alran auth login · status · switch-company · logout` | Your Ottili account ([Sign in](https://alran.dev/en/docs/auth)) |
| `alran config company · project · model` | The company, project and default model |
| `alran models` | Models, prices and whether you can use them |
| `alran usage` | Credit left and this month’s spend per model |
| `alran billing` | Plan, payment method, last invoice |
| `alran provider list · add · remove · test · use` | Your own providers and keys ([Your own provider](https://alran.dev/en/docs/byok)) |
| `alran plugin search · info · install · update · remove · marketplace` | Plugin Store ([Plugins](https://alran.dev/en/docs/plugins)) |
| `alran skills list · search · info · install · update · remove` | Skill Library ([Plugins](https://alran.dev/en/docs/plugins)) |
| `alran acp` | Run as an Agent Client Protocol server ([Node.js and ACP](https://alran.dev/en/docs/sdk)) |
| `alran update` | Check for and install an update |
| `alran telemetry` | Inspect anonymous usage reporting |
| `alran mascot` | Meet the Alran mascot |

## Options of alran {#options}

| Option | What it does |
| `-m, --model <provider/model>` | The model for this session only |
| `-c, --continue` | Continue 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, --version` | The version |

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

## Common questions {#faq}

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.

[PreviousWerk API](https://alran.dev/en/docs/api) [NextSlash commands](https://alran.dev/en/docs/commands)
