在你的终端里放一个最小编码代理。

Alan 目前是一个早期原型。部分功能仍在开发中，发布间行为可能会有所变化。

目录

• 特色
• 安装
• 提供者
• 使用情况
• 权限
• 定制供应商
• 技能
• 配置和数据位置
• 从源头构建
• 要求

特色

• 一流的OpenRouter支持 — 完整模型目录、按型号上游提供者钉钉（/model-providers）和推理工作控制（/effort）。
• 粘贴图片 — 直接从剪贴板上传截图进入对话并询问相关内容。
• 紧凑且聚焦 — /summarize-new "focus hint" 总结了上下文，并从真正重要的内容开始。
• 引导 — 在消息运行中排队，代理在不等待响应完成的情况下接取。
• 计划和复习模式 — 当你希望代理先思考再行动时，可以用Shift+Tab循环切换。
• 技能 — 在提示中输入#name，将技能的完整指令附加到该信息后。

Alan

A minimal coding agent in your terminal.

Alan is currently an early prototype. Some features are still being developed, and behavior may change between releases.

Table of Contents

• Features
• Installation
• Providers
• Usage
• Permissions
• Custom providers
• Skills
• Configuration and data locations
• Building from source
• Requirements

Features

• First-class OpenRouter support — full model catalog, per-model upstream provider pinning (/model-providers), and reasoning effort control (/effort).
• Paste images — drop a screenshot from your clipboard straight into the conversation and ask about it.
• Compact with focus — /summarize-new "focus hint" summarizes the context and restarts with just what matters.
• Steering — queue a message mid-run and the agent picks it up without waiting for the response to finish.
• Plan and review modes — cycle through them with Shift+Tab when you want the agent to think before it acts.
• Skills — type #name in the prompt to attach a skill’s full instructions to that message.
• Custom providers — add any Chat Completions server, hosted or on your machine, with /provider add; all of its models appear in /models.

Installation

Prebuilt binaries are published through GitHub Releases. The installer detects your operating system and CPU architecture, downloads the matching binary, verifies it, and installs alan into Cargo’s binary directory.

macOS and Linux

curl -fsSL https://github.com/Revantark/alan/releases/latest/download/alan-installer.sh | bash

Restart your shell or ensure ~/.cargo/bin is on your PATH, then run:

alan

Windows

Not supported yet.

Updating

The installer also installs alan-update next to alan (in Cargo’s binary directory, ~/.cargo/bin). Run it to check for a newer release and install it:

alan-update

It takes no arguments and needs no confirmation. To see the installed version:

alan --version

alan-update only exists for installations that ran the installer after it started shipping the updater. If you installed earlier, or you built from source, run the installer command once to get it. Alan also shows an update notice on startup when a newer release is published.

Providers

Alan currently supports:

• OpenRouter
• DeepSeek
• Zai (beta)
• ChatGPT (beta, unofficial): signs in with your own ChatGPT subscription account through the browser. OpenAI has not published this backend, so access depends on OpenAI’s terms and may stop working at any time. Personal use only; not for hosted or multi-user apps.

Use the /login command to sign in to any of the available providers.