Sakrylle CLI

Sakrylle CLI 是一款本地运行的 AI 编程代理，基于 OpenAI Codex CLI 二次开发。它通过全屏 TUI（终端用户界面）与模型交互，自动读写本地文件、执行终端命令，并在沙盒环境中安全运行，帮助你完成编码、调试、重构等编程任务。

仓库：https://github.com/Ranshen1209/sakrylle-cli
二进制名：sakrylle（别名 skl）
平台支持：当前公开安装包仅支持 macOS arm64；Windows 与 Linux 版本开发中
许可证：Apache-2.0
控制台：https://ai1.sakrylle.com
技术栈：Rust 工作空间（约 100 个 crate）+ TypeScript 包装器

Sakrylle CLI 是 Codex CLI 的功能扩展分支，不是原版 Codex CLI 的直接替代品。如果你原本使用 Codex CLI，请注意两者在配置路径、默认供应商和环境变量方面的差异。完整对比见下方与 Codex CLI 的区别。

安装

macOS arm64 安装

bash

curl -fsSL https://cli.sakrylle.com/install.sh | sh

安装脚本将二进制文件放到 ~/.local/bin/sakrylle，并创建 skl 别名。要求 macOS 12+，ARM64 架构。

macOS arm64 卸载

bash

curl -fsSL https://cli.sakrylle.com/uninstall.sh | sh

登录与认证

Sakrylle CLI 支持多种认证方式，默认使用 ChatGPT OAuth 浏览器登录。

ChatGPT OAuth（默认）

bash

sakrylle login

打开浏览器完成 OAuth 授权，登录成功后凭证保存到本地。

API Key

bash

printenv SAKRYLLE_API_KEY | sakrylle login --with-api-key

Access Token

bash

printenv SAKRYLLE_ACCESS_TOKEN | sakrylle login --with-access-token

Device Code OIDC

bash

sakrylle login --device-auth

终端显示设备码和 URL，在浏览器中输入设备码完成授权。

查看登录状态

bash

sakrylle login status

退出登录

bash

sakrylle logout

移除本地保存的凭证。

命令总览

命令	别名	说明
`sakrylle`	`skl`	启动交互式 TUI
`sakrylle exec`	`sakrylle e`	非交互式执行
`sakrylle review`	--	审查代码变更（`exec review` 别名）
`sakrylle login`	--	认证登录
`sakrylle logout`	--	退出登录
`sakrylle mcp`	--	管理 MCP 服务器
`sakrylle plugin`	--	管理插件
`sakrylle resume`	--	恢复交互式会话
`sakrylle fork`	--	分叉会话
`sakrylle archive`	--	归档会话
`sakrylle unarchive`	--	取消归档会话
`sakrylle apply`	`sakrylle a`	通过 git apply 应用最新 diff
`sakrylle completion`	--	生成 Shell 补全脚本
`sakrylle doctor`	--	诊断安装问题
`sakrylle sandbox`	--	在沙盒中运行命令
`sakrylle cloud`	`cloud-tasks`	[实验性] 云端任务
`sakrylle app-server`	--	[实验性] 应用服务器
`sakrylle remote-control`	--	[实验性] 守护进程管理
`sakrylle app`	--	启动桌面应用（macOS/Windows）
`sakrylle debug`	--	调试工具
`sakrylle features`	--	功能开关管理
`sakrylle mcp-server`	--	以 MCP 服务器模式启动（stdio）

`sakrylle`（交互式 TUI）

启动全屏终端用户界面，通过对话方式与 AI 模型交互。

bash

sakrylle

全局标志

这些标志适用于 sakrylle 以及 resume、fork 等所有启动 TUI 的命令。

标志	缩写	说明
`--config`	`-c`	指定配置文件路径（覆盖默认 `~/.sakrylle-cli/config.toml`）
`--enable`	--	启用指定功能开关
`--disable`	--	禁用指定功能开关
`--remote`	--	连接到远程应用服务器
`--remote-auth-token-env`	--	指定远程认证 token 的环境变量名
`--model`	`-m`	指定使用的模型
`--oss`	--	使用本地 OSS 模型
`--local-provider`	--	使用本地模型供应商
`--profile`	`-p`	使用指定配置 profile
`--sandbox`	`-s`	沙盒模式：`read-only`（只读）、`workspace-write`（允许写工作区）、`danger-full-access`（完全访问）
`--ask-for-approval`	`-a`	审批策略：`untrusted`（不可信操作需审批）、`on-request`（按需审批）、`never`（永不审批）
`--dangerously-bypass-approvals-and-sandbox`	`--yolo`	跳过所有审批和沙盒限制（危险操作）
`--dangerously-bypass-hook-trust`	--	跳过 Hook 信任验证
`--cd`	`-C`	设置工作目录
`--image`	`-i`	传入图片路径
`--add-dir`	--	添加额外目录到上下文
`--search`	--	启用搜索功能
`--no-alt-screen`	--	不使用备用屏幕缓冲区
`--strict-config`	--	严格配置模式，配置错误时拒绝启动

TUI 内置命令

在 TUI 交互界面中，可以使用斜杠命令：

命令	说明
`/vim`	切换 Vim 编辑模式
`/theme`	切换自定义主题
`/keymap`	自定义键位映射
`/copy`	复制最新响应到剪贴板
`/side`	启动侧边对话
`/btw`	快速侧边对话
`/plan`	进入 Plan 模式
`/compact`	手动压缩对话上下文
`/init`	生成 AGENTS.md 文件
`/ps`	查看后台终端
`/stop`	停止后台终端

TUI 快捷键

快捷键	说明
`Ctrl+G`	打开提示词编辑器
`Up/Down`	浏览草稿历史
`Ctrl+R`	搜索提示词历史
`Ctrl+O`	复制最新响应

`sakrylle exec`

非交互模式，直接传入提示词执行并返回结果，适合脚本和管道使用。

bash

sakrylle exec "解释当前目录的文件结构"

标志

标志	缩写	说明
`PROMPT`	--	要执行的提示词（位置参数）
`--image`	`-i`	传入图片路径
`--model`	`-m`	指定模型
`--oss`	--	使用本地 OSS 模型
`--sandbox`	`-s`	沙盒模式
`--profile`	`-p`	使用指定 profile
`--skip-git-repo-check`	--	跳过 git 仓库检查
`--ephemeral`	--	临时模式，不保存会话历史
`--ignore-user-config`	--	忽略用户级配置
`--ignore-rules`	--	忽略 AGENTS.md 等规则文件
`--output-schema`	--	指定输出 schema
`--color`	--	颜色输出：`always`、`never`、`auto`
`--json`	--	JSON 格式输出
`--output-last-message`	`-o`	仅输出最后一条消息
`--strict-config`	--	严格配置模式
`-c` / `--config`	--	指定配置文件路径
`--yolo`	--	跳过审批和沙盒限制
`--dangerously-bypass-hook-trust`	--	跳过 Hook 信任验证
`--cd`	`-C`	设置工作目录
`--full-auto`	--	（已废弃）完全自动模式

示例

bash

# 简单执行
sakrylle exec "列出所有 TODO 注释"

# 指定模型
sakrylle exec -m gpt-5.4 "重构这个函数"

# JSON 输出
sakrylle exec --json "分析项目依赖"

# 仅输出最后消息
sakrylle exec -o "读取 README.md 的前 5 行"

`exec resume`

bash

sakrylle exec resume [SESSION_ID]

标志	说明
`SESSION_ID`	要恢复的会话 ID（位置参数）
`--last`	恢复最近一次会话
`--all`	列出所有可恢复的会话
`PROMPT`	后续提示词
`--image`	传入图片路径

`exec review`（代码审查）

bash

sakrylle exec review
sakrylle review  # 别名

标志	说明
`--uncommitted`	审查未提交的变更
`--base`	指定基准分支
`--commit`	指定审查的 commit SHA
`--title`	审查标题
`PROMPT`	附加提示词

bash

# 审查当前未提交的变更
sakrylle review --uncommitted

# 审查与 main 分支的差异
sakrylle review --base main

# 审查特定 commit
sakrylle review --commit abc1234

`sakrylle login`

bash

sakrylle login [FLAGS]

标志

标志	说明
`--with-api-key`	从 stdin 读取 API Key 进行登录
`--with-access-token`	从 stdin 读取 Access Token 进行登录
`--api-key`	（已废弃兼容）旧版 API Key 参数；新用法请改为 `--with-api-key`
`--device-auth`	使用 Device Code OIDC 认证

`login status`

bash

sakrylle login status

显示当前认证状态和关联的账户信息。

`sakrylle logout`

bash

sakrylle logout

移除本地保存的所有认证凭证。

`sakrylle mcp`

管理 Model Context Protocol (MCP) 服务器连接。

bash

sakrylle mcp <subcommand> [FLAGS]

`mcp list`

列出所有已配置的 MCP 服务器。

bash

sakrylle mcp list [--json]

`mcp get`

查看指定 MCP 服务器的详情。

bash

sakrylle mcp get <name> [--json]

`mcp add`

添加新的 MCP 服务器。

bash

# 通过命令添加
sakrylle mcp add <name> -- <command...>

# 通过 URL 添加（SSE 传输）
sakrylle mcp add <name> --url URL

选项	说明
`--env KEY=VALUE`	设置环境变量（可多次使用）
`--url`	指定 SSE 传输的 URL
`--bearer-token-env-var`	指定 Bearer Token 的环境变量名
`--oauth-client-id`	OAuth 客户端 ID
`--oauth-resource`	OAuth 资源标识符

`mcp remove`

移除指定的 MCP 服务器。

bash

sakrylle mcp remove <name>

`mcp login`

登录指定的 MCP 服务器。

bash

sakrylle mcp login <name> [--scopes SCOPE1,SCOPE2]

`mcp logout`

退出指定的 MCP 服务器。

bash

sakrylle mcp logout <name>

示例

bash

# 添加一个本地 MCP 服务器
sakrylle mcp add my-server -- npx -y @modelcontextprotocol/server-everything

# 添加带环境变量的 MCP 服务器
sakrylle mcp add my-server --env API_KEY=sk-xxx -- npx my-mcp-server

# 添加 SSE 类型的远程 MCP 服务器
sakrylle mcp add remote-server --url https://mcp.example.com/sse

# 列出所有 MCP 服务器
sakrylle mcp list --json

`sakrylle plugin`

管理 Sakrylle CLI 插件。

bash

sakrylle plugin <subcommand> [FLAGS]

`plugin add`

安装插件。

bash

sakrylle plugin add <plugin[@marketplace]> [-m]

标志	说明
`-m`	从 marketplace 安装

`plugin list`

列出已安装的插件。

bash

sakrylle plugin list [-m] [--json] [--available]

标志	说明
`-m`	列出 marketplace 中的插件
`--json`	JSON 格式输出
`--available`	列出可用（未安装）的插件

`plugin remove`

移除指定插件。

bash

sakrylle plugin remove <plugin[@marketplace]> [-m]

`plugin market`

bash

# 添加 marketplace 源
sakrylle plugin marketplace add <SOURCE> [--ref REF] [--sparse PATH]

# 列出已添加的 marketplace
sakrylle plugin marketplace list

# 升级 marketplace 中的插件
sakrylle plugin marketplace upgrade [NAME]

# 移除 marketplace
sakrylle plugin marketplace remove <NAME>

`sakrylle resume`

继续之前保存的交互式会话。

bash

sakrylle resume [SESSION_ID] [FLAGS]

标志	说明
`SESSION_ID`	要恢复的会话 ID（位置参数）
`--last`	恢复最近一次会话
`--all`	列出所有可恢复的会话
`--include-non-interactive`	也包含非交互式会话

此外还支持所有 TUI 全局标志（--model、--sandbox、--profile 等）。

bash

# 恢复最近的会话
sakrylle resume --last

# 列出所有会话并选择
sakrylle resume --all

# 恢复指定会话
sakrylle resume abc1234

`sakrylle fork`

从已有会话创建新分支，保留原始会话不变。

bash

sakrylle fork [SESSION_ID] [FLAGS]

标志	说明
`SESSION_ID`	要分叉的源会话 ID
`--last`	分叉最近一次会话
`--all`	列出所有可分叉的会话

此外还支持所有 TUI 全局标志。

archive / unarchive

归档

bash

sakrylle archive <SESSION>

将指定会话归档，从活跃列表中隐藏。

取消归档

bash

sakrylle unarchive <SESSION>

将归档的会话恢复到活跃列表。

`sakrylle apply`

将 AI 生成的最新 diff 通过 git apply 应用到当前工作区。

bash

sakrylle apply [TASK_ID]
sakrylle a [TASK_ID]  # 别名

标志	说明
`TASK_ID`	指定要应用的任务 ID（可选，默认使用最近一次）

completion

生成 Shell 自动补全脚本。

bash

sakrylle completion [SHELL]

支持的 Shell：bash、zsh、fish、powershell、elvish。

bash

# bash
sakrylle completion bash >> ~/.bashrc

# zsh
sakrylle completion zsh >> ~/.zshrc

# fish
sakrylle completion fish > ~/.config/fish/completions/sakrylle.fish

`sakrylle doctor`（诊断）

诊断安装环境和配置问题。

bash

sakrylle doctor [FLAGS]

标志	说明
`--json`	JSON 格式输出
`--summary`	仅显示摘要
`--all`	显示所有诊断项
`--no-color`	禁用彩色输出
`--ascii`	使用 ASCII 字符绘制图表

`sakrylle sandbox`

在隔离的沙盒环境中运行指定命令，防止意外修改系统文件。

bash

sakrylle sandbox [FLAGS] COMMAND...

macOS（Seatbelt）

使用 macOS 原生 Seatbelt 沙盒机制（sandbox-exec）。

标志	说明
`--permissions-profile`	指定权限配置文件
`--profile` / `-p`	使用指定的沙盒 profile
`--cd` / `-C`	设置工作目录
`--include-managed-config`	包含管理配置
`--allow-unix-socket`	允许 Unix socket 通信
`--log-denials`	记录被拒绝的操作
`-c`	以命令字符串形式执行
`COMMAND...`	要执行的命令

Linux（Landlock）

使用 Linux Landlock + seccomp 沙盒机制。标志与 macOS 基本一致，但不支持 --allow-unix-socket 和 --log-denials。

`sakrylle cloud`

实验性功能，API 和行为可能在后续版本中变更。

通过 Sakrylle API 在云端执行任务。

bash

sakrylle cloud <subcommand>
sakrylle cloud-tasks <subcommand>  # 别名

`cloud exec`

在云端执行任务。

`cloud list`

列出云端任务。

`app-server`

实验性功能，API 和行为可能在后续版本中变更。

启动 Sakrylle 应用服务器，提供 HTTP/stdio 接口。

bash

sakrylle app-server [FLAGS]

标志

标志	说明
`--listen URL`	监听地址（如 `http://0.0.0.0:3000`）
`--stdio`	使用 stdio 传输
`--remote-control`	启用远程控制功能
`--analytics-default-enabled`	默认启用分析数据收集
`--strict-config`	严格配置模式

子命令

`app-server daemon`

管理应用服务器守护进程。

bash

sakrylle app-server daemon start       # 启动守护进程
sakrylle app-server daemon restart     # 重启守护进程
sakrylle app-server daemon stop        # 停止守护进程
sakrylle app-server daemon version     # 查看守护进程版本
sakrylle app-server daemon bootstrap   # 初始化守护进程配置
sakrylle app-server daemon enable-remote-control   # 启用远程控制
sakrylle app-server daemon disable-remote-control  # 禁用远程控制

`app-server proxy`

启动代理服务器。

bash

sakrylle app-server proxy [--sock]

`app-server generate-ts`

生成 TypeScript 类型定义。

bash

sakrylle app-server generate-ts

JSON schema

生成 JSON Schema。

bash

sakrylle app-server generate-json-schema

`remote-control`

实验性功能，API 和行为可能在后续版本中变更。

管理 Sakrylle 守护进程的远程控制功能。

bash

sakrylle remote-control [FLAGS] <subcommand>

标志	说明
`--json`	JSON 格式输出

bash

sakrylle remote-control start   # 启动远程控制
sakrylle remote-control stop    # 停止远程控制

`sakrylle app`（桌面应用）

仅 macOS 和 Windows 平台可用，启动 Sakrylle 桌面应用。

bash

sakrylle app

`sakrylle debug`

提供调试和诊断相关的子命令。

bash

sakrylle debug <subcommand>

`debug models`

列出可用模型。

bash

sakrylle debug models [--bundled]

标志	说明
`--bundled`	仅显示内置模型

send-message-v2

向应用服务器发送消息（用于调试）。

bash

sakrylle debug app-server send-message-v2

`debug prompt-input`

提示词输入调试工具。

bash

sakrylle debug prompt-input [PROMPT] [--image]

clear-memories

清除本地记忆存储。此命令为隐藏命令，不会在帮助信息中显示。

bash

sakrylle debug clear-memories

`sakrylle features`

管理 Sakrylle CLI 的功能开关（Feature Flags）。

bash

sakrylle features <subcommand>

`features list`

列出所有功能开关及其当前状态。

bash

sakrylle features list

`features enable`

启用指定功能开关。

bash

sakrylle features enable <feature>

`features disable`

禁用指定功能开关。

bash

sakrylle features disable <feature>

`mcp-server`

以 MCP 服务器模式启动 Sakrylle CLI，通过 stdio 与外部客户端通信。

bash

sakrylle mcp-server

此模式下 Sakrylle CLI 作为标准 MCP 服务器运行，可供 Claude Desktop、Cursor 等支持 MCP 的客户端调用。

配置

Sakrylle CLI 使用 TOML 格式的配置文件，位于 ~/.sakrylle-cli/config.toml。可通过环境变量 SAKRYLLE_CLI_HOME 修改配置目录位置。

配置层级

配置按以下优先级从低到高覆盖：

内置默认值（built-in）
系统级配置（system）
用户级配置（user）：~/.sakrylle-cli/config.toml
Profile 配置（profile）
项目级配置（project）：项目根目录下的配置文件
CLI 标志覆盖（CLI overrides）

高优先级的配置会覆盖低优先级的同名字段。

基础配置字段

toml

# 默认模型
model = "gpt-5.6-sol"

# 审查模型（用于 review 等命令）
review_model = "gpt-5.4"

# 模型供应商
model_provider = "sakrylle"

# 上下文窗口大小（token 数）
model_context_window = 200000

# 自动压缩的 token 阈值
model_auto_compact_token_limit = 100000

# 审批策略：untrusted | on-failure | on-request | granular | never
approval_policy = "untrusted"

# 沙盒模式
sandbox_mode = "read-only"

# 自定义系统提示词
instructions = "你是一个专业的编程助手。"

# 开发者提示词（附加到 instructions 之后）
developer_instructions = ""

# 联网搜索模式：live | cached | disabled
web_search = "live"

# 对话风格：friendly | pragmatic | none
personality = "friendly"

# 服务等级
service_tier = ""

# 推理努力程度：low | medium | high
model_reasoning_effort = "medium"

# 当前使用的 profile
profile = "default"

# 强制登录方式：api | chatgpt
# forced_login_method = "api"

# 凭证存储方式：file | keyring | auto | ephemeral
# cli_auth_credentials_store = "auto"

模型供应商配置

toml

[model_providers.sakrylle]
name = "Sakrylle API"
base_url = "https://api.sakrylle.com/v1"
env_key = "SAKRYLLE_API_KEY"
wire_api = "responses"  # 或 "chat"

# 你可以添加多个供应商
[model_providers.ollama]
name = "Ollama Local"
base_url = "http://localhost:11434/v1"
env_key = "OLLAMA_API_KEY"
wire_api = "chat"

字段说明：

name：供应商显示名称
base_url：API 端点地址，OpenAI 兼容格式
env_key：存放 API Key 的环境变量名
wire_api：API 协议类型，responses（OpenAI Responses API）或 chat（Chat Completions API）

Profile 配置

Profile 允许为不同场景保存不同的配置组合：

toml

[profiles.work]
model = "gpt-5.4"
model_provider = "sakrylle"
sandbox_mode = "read-only"

[profiles.personal]
model = "gpt-5.6-sol"
model_provider = "sakrylle"
sandbox_mode = "workspace-write"

启动时通过 --profile 标志选择：

bash

sakrylle --profile work

MCP 服务器配置

toml

[[mcp_servers]]
name = "my-server"
command = ["npx", "-y", "@modelcontextprotocol/server-everything"]

[[mcp_servers]]
name = "remote-server"
url = "https://mcp.example.com/sse"

Hook 配置

Hooks 允许在特定事件前后执行自定义脚本。

toml

[hooks]

Agent 配置

toml

[agents]
# 自定义 Agent 配置

记忆配置

toml

[memories]
# 本地记忆存储配置

Skill 配置

toml

[skills]
# 自定义 Skill 配置

Tool 配置

toml

[tools]
# 自定义 Tool 配置

功能开关配置

Sakrylle CLI 提供 80+ 个功能开关，用于控制实验性功能的启用状态：

toml

[features]
# 示例：启用或禁用特定功能

也可以通过命令行管理：

bash

sakrylle features list
sakrylle features enable <feature>
sakrylle features disable <feature>

TUI 配置

toml

[tui]
# TUI 相关配置

历史记录配置

toml

[history]
# 会话历史记录配置

分析数据配置

toml

[analytics]
# 分析数据收集配置

[otel]
# OpenTelemetry 配置

其他配置字段

toml

# SQLite 数据库存储目录
sqlite_home = ""

# 日志输出目录
log_dir = ""

环境变量

核心环境变量

环境变量	说明
`SAKRYLLE_CLI_HOME`	Sakrylle CLI 配置目录路径（默认 `~/.sakrylle-cli/`）
`SAKRYLLE_SQLITE_HOME`	SQLite 数据库存储路径
`CODEX_HOME`	Codex CLI 兼容的配置目录路径（旧版兼容）

认证环境变量

环境变量	说明
`CODEX_API_KEY`	OpenAI/Codex API Key（旧版兼容）
`CODEX_ACCESS_TOKEN`	Codex Access Token（旧版兼容）
`SAKRYLLE_API_KEY`	Sakrylle API Key

模型供应商环境变量

环境变量	说明
`CODEX_OSS_PORT`	本地 OSS 模型端口
`CODEX_OSS_BASE_URL`	本地 OSS 模型基础 URL
`SAKRYLLE_API_BASE_URL`	Sakrylle API 基础 URL

沙盒环境变量

环境变量	说明
`CODEX_SANDBOX`	沙盒模式设置
`CODEX_SANDBOX_NETWORK_DISABLED`	禁用沙盒网络
`CODEX_THREAD_ID`	线程 ID

沙盒机制

Sakrylle CLI 在不同操作系统上使用不同的沙盒技术来隔离 AI 代理的文件系统和进程访问。

macOS（Seatbelt）

macOS 上使用 Apple Seatbelt（sandbox-exec）机制，通过权限配置文件控制 AI 代理可以访问的文件和操作。

Linux

Linux 版本仍在开发中，当前没有公开发布包。

Windows

Windows 版本仍在开发中，当前没有公开发布包。

沙盒模式

模式	说明
`read-only`	只读模式，AI 代理无法修改任何文件
`workspace-write`	允许写入当前工作区内的文件
`danger-full-access`	完全访问，无沙盒限制（仅用于完全信任的场景）

与 Codex CLI 的区别

Sakrylle CLI 基于 OpenAI Codex CLI 二次开发，以下是两者的主要差异：

方面	Codex CLI	Sakrylle CLI
二进制名	`codex`	`sakrylle` / `skl`
配置目录	`~/.codex/`	`~/.sakrylle-cli/`
默认供应商	openai	sakrylle
API Key 环境变量	`OPENAI_API_KEY`	`SAKRYLLE_API_KEY`
认证方式	ChatGPT OAuth + API Key	+ OIDC 设备码认证
图像生成	启用	对 Sakrylle 禁用
codex_apps MCP	启用	禁用
update 命令	存在	已移除

如果你从 Codex CLI 迁移到 Sakrylle CLI，需要更新配置目录路径、环境变量名和二进制调用方式。

旧版兼容参数不建议继续写入脚本：sakrylle login --api-key 请改用 sakrylle login --with-api-key；sakrylle exec --full-auto 请改用显式沙盒参数，例如 --sandbox workspace-write。其他隐藏命令多用于内部调试或集成，不作为普通用户接口公开。

常见问题

sakrylle: command not found：检查安装路径是否在 PATH 中。curl 安装的二进制位于 ~/.local/bin/sakrylle，确保 ~/.local/bin 在 PATH 里。运行 sakrylle doctor 检查环境
401 / 认证失败：运行 sakrylle login status 检查凭证状态。如已过期，重新执行 sakrylle login
402 余额不足：登录控制台 https://ai1.sakrylle.com/purchase 充值
404 / model not found：检查 model 字段是否填写了有效的模型名。运行 sakrylle debug models 查看可用模型列表
沙盒权限被拒绝：使用 --sandbox workspace-write 允许写入工作区，或 --sandbox danger-full-access 完全放开（不推荐）
配置解析失败：运行 sakrylle doctor 检查配置文件语法。使用 --strict-config 标志可以获取更详细的错误信息
MCP 服务器连接失败：检查 MCP 服务器进程是否正常运行，以及 URL/命令是否正确。使用 sakrylle mcp list 查看已配置的服务器
TUI 显示异常：确保终端支持 Unicode 和 256 色。尝试 --no-alt-screen 标志。运行 sakrylle doctor 检查终端兼容性
与 Codex CLI 配置冲突：Sakrylle CLI 使用独立的配置目录（~/.sakrylle-cli/），不会覆盖 Codex CLI 的 ~/.codex/ 配置
Windows / Linux 用户：当前暂无公开版本，相关平台仍在开发中

Sakrylle CLI ​

安装 ​

macOS arm64 安装 ​

macOS arm64 卸载 ​

登录与认证 ​

ChatGPT OAuth（默认） ​

API Key ​

Access Token ​

Device Code OIDC ​

查看登录状态 ​

退出登录 ​

命令总览 ​

sakrylle（交互式 TUI） ​

全局标志 ​

TUI 内置命令 ​

TUI 快捷键 ​

sakrylle exec ​

标志 ​

示例 ​

exec resume ​

exec review（代码审查） ​

sakrylle login ​

标志 ​

login status ​

sakrylle logout ​

sakrylle mcp ​

mcp list ​

mcp get ​

mcp add ​

mcp remove ​

mcp login ​

mcp logout ​

示例 ​

sakrylle plugin ​

plugin add ​

plugin list ​

plugin remove ​

plugin market ​

sakrylle resume ​

sakrylle fork ​

archive / unarchive ​

归档 ​

取消归档 ​

sakrylle apply ​

completion ​

sakrylle doctor（诊断） ​

sakrylle sandbox ​

macOS（Seatbelt） ​

Linux（Landlock） ​

sakrylle cloud ​

cloud exec ​

cloud list ​

app-server ​

标志 ​

子命令 ​

app-server daemon ​

app-server proxy ​

app-server generate-ts ​

JSON schema ​

remote-control ​

sakrylle app（桌面应用） ​

sakrylle debug ​

debug models ​

send-message-v2 ​

debug prompt-input ​

clear-memories ​

sakrylle features ​

features list ​

features enable ​

features disable ​

mcp-server ​

配置 ​

配置层级 ​

基础配置字段 ​

模型供应商配置 ​

Profile 配置 ​

MCP 服务器配置 ​

Hook 配置 ​

Agent 配置 ​

记忆配置 ​

Sakrylle CLI

安装

macOS arm64 安装

macOS arm64 卸载

登录与认证

ChatGPT OAuth（默认）

API Key

Access Token

Device Code OIDC

查看登录状态

退出登录

命令总览

`sakrylle`（交互式 TUI）

全局标志

TUI 内置命令

TUI 快捷键

`sakrylle exec`

标志

示例

`exec resume`

`exec review`（代码审查）

`sakrylle login`

标志

`login status`

`sakrylle logout`

`sakrylle mcp`

`mcp list`

`mcp get`

`mcp add`

`mcp remove`

`mcp login`

`mcp logout`

示例

`sakrylle plugin`

`plugin add`

`plugin list`

`plugin remove`

`plugin market`

`sakrylle resume`

`sakrylle fork`

archive / unarchive

归档

取消归档

`sakrylle apply`

completion

`sakrylle doctor`（诊断）

`sakrylle sandbox`

macOS（Seatbelt）

Linux（Landlock）

`sakrylle cloud`

`cloud exec`

`cloud list`

`app-server`

标志

子命令

`app-server daemon`

`app-server proxy`

`app-server generate-ts`

JSON schema

`remote-control`

`sakrylle app`（桌面应用）

`sakrylle debug`

`debug models`

send-message-v2

`debug prompt-input`

clear-memories

`sakrylle features`

`features list`

`features enable`

`features disable`

`mcp-server`

配置

配置层级

基础配置字段

模型供应商配置

Profile 配置

MCP 服务器配置

Hook 配置

Agent 配置

记忆配置