CLI 手册

本地终端 Agent · 24 个子命令 · 31 个内置斜杠命令 · 安装见 下载页 · 模型接入见 API 文档

快速开始

neyino            # 在项目目录启动(首条消息前用 /connect 连接模型)
neyino run "..."  # 非交互:带一条消息直接执行
neyino --help     # 查看全部子命令

斜杠命令(TUI 内输入)

在输入框以 / 开头调用;带参数的命令在 / 后空格会弹出补全。桌面版另有 /presets(提示词预设)。

命令别名说明
/sessions—切换会话
/new—新建会话
/clear—清空当前会话
/openprojects project打开会话或项目
/models—列出并切换可用模型
/model <模型>—直接设置当前模型(输入空格弹出候选)
/agents—切换 agent
/crew [list|remote]—进入 Crew 模式;list 看子会话,remote 开远程控制台
/lead—把本会话切换为 Captain
/usage—查看用量统计
/memory—查看记忆库
/remember <内容>—记下一条长期记忆
/recall <查询>—语义搜索记忆
/initialize <文件>—从文件(如 AGENTS.md)导入记忆
/mcps—查看 MCP 服务器状态
/variantsthinking effort切换模型变体(思考档)
/connect—连接模型服务或集成(Neyino Console / API Key / 其他厂商)
/highlights—查看当前版本更新亮点
/settings—打开设置
/status—查看余额、今日用量与限速
/update—检查并安装新版本
/pairweb生成一次性配对链接(连接浏览器或手机)
/restart—重启后台服务
/reload—重载配置(不重启服务)
/debug—查看调试信息
/doctor—运行健康检查
/themes—切换主题
/help—打开帮助
/exitquit q退出 neyino
/init—引导式创建 AGENTS.md(项目规范与记忆)
/review [commit|branch|pr]—审查改动,默认未提交的

自定义命令:在配置目录的 command/(或 commands/)下放 .md 文件,frontmatter 写 description,正文即模板,重载后以同名斜杠命令出现。MCP 服务器提供的 prompt 也会注册为斜杠命令。

命令行子命令

在 shell 中调用;每个子命令可用 neyino <子命令> --help 查看专属参数。

子命令说明
upgrade / update升级到最新或指定版本
uninstall卸载(保留会话、配置与状态)
acp启动 Agent Client Protocol 服务器(供编辑器集成)
api向运行中的服务发请求(OpenAPI operation 或 method + path)
debug调试与排障:agents / config / heap-dump / paths
auth管理集成与凭据:list / login / logout / export / import / switch
doctor运行健康检查并报告安装问题
node注册工作节点并派发任务:add / list / remove / dispatch
bot把 IM 平台消息中继进会话(目前支持 telegram)
memory操作本地记忆中枢(export 导出可分享片段)
mcp管理 MCP 服务器:list / add / auth / logout / serve
plugin管理插件:list / add / check / update / remove
models列出全部可用模型
status查看积分余额、今日用量与限速
stats分享用量统计(--days / --year / --all / --models)
mini启动极简交互界面
proxy在 127.0.0.1 起 Anthropic/Gemini wire 网关,供任意 AI 客户端使用
dispatch并行执行 jobs 文件(JSONL 或 JSON 数组)并收集结果
run带一条消息运行 neyino(非交互)
session管理会话:list / delete / export / import
service管理后台服务:start / restart / status / stop / get / set / unset
reload重载配置
pair打印一次性链接,连接浏览器或手机应用
serve启动 v2 API 与 web 服务器

全局参数

参数说明
--wizard交互式命令构建器:逐步问答,生成完整命令行(是全局 flag,不是斜杠命令)
--standalone用私有服务运行,不连后台服务
--server <url>连接指定服务地址
--auto自动批准未显式拒绝的权限
-c, --continue续接上一会话
-s, --session <id>指定会话(不存在则创建)
--prompt <text>启动时附带一条消息
--completions <shell>打印 shell 补全脚本(bash / zsh / fish / sh)
--log-level / --print-logs设置日志级别 / 输出日志到 stderr
-h / -v帮助 / 版本

按角色配模型(配置参考)

默认所有会话共用一个全局模型;可以给单个 agent 单独指定——比如船长用强模型、干杂活的用便宜快模型。改完执行 neyino reload(或 TUI 里 /reload)即生效,不用重启服务。

取模型的顺序(先命中先用):

配置片段(~/.config/neyino/neyino.jsonc):

{
  "model": "xiaomi/mimo-v2.6-flash",
  "agents": {
    "captain": { "model": "xiaomi/mimo-v2.6-pro" },
    "general": { "model": "deepseek/deepseek-flash" }
  }
}

含义:全局默认 mimo-v2.6-flash;captain(船长)升级用 mimo-v2.6-pro;general(杂活)用便宜快的 deepseek-flash。只写需要覆盖的 agent,其余全部走全局。

常见坑:

hooks(工具生命周期钩子)

配置顶层 hooks 键(不是 experimental),在四个事件点执行 shell 命令。每条规则 = matcher(对工具名的正则,省略=匹配所有工具)+ command(事件 JSON 从 stdin 传入)+ timeout(如 "30 seconds",默认 60 秒)。改完 neyino reload 即生效。

真实可用片段——PostToolUse 给写入的 Python 文件跑语法检查(只查 .py,出错时 exit 2 把报错交给模型):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "write",
        "command": "python3 -c 'import json,sys;d=json.load(sys.stdin);i=d[\"input\"];compile(i.get(\"content\") or \"\",i[\"path\"],\"exec\") if i[\"path\"].endswith(\".py\") else None' || exit 2",
        "timeout": "30 seconds"
      }
    ]
  }
}

四个事件与退出码语义:

常见坑:

MCP(接入外部工具服务器)

MCP = Model Context Protocol:把外部工具服务器(本地进程或远程 HTTP)接进会话。配置写在 neyino.json 的 mcp.servers 下。

neyino mcp add demo -- node server.js      # 本地 stdio:服务器命令跟在 -- 后
neyino mcp add hub -- $(command -v neyino) mcp serve   # 本机记忆中枢(见坑:勿用裸 neyino)
neyino mcp add remote --url https://example.com/mcp --header Authorization=Bearer xxx
neyino mcp add demo --global               # 写全局配置 ~/.config/neyino/neyino.json(所有项目生效)
neyino mcp list                            # 查看各服务器连接状态
neyino mcp auth <name>                     # 远程服务器 OAuth 授权;neyino mcp logout <name> 清凭据
neyino mcp serve                           # 反向:把本机记忆中枢以 stdio 暴露给 Claude/Cursor 等客户端

常见坑:

权限(allow / ask / deny)

配置顶层 permissions 数组,每条 = action(工具名)+ resource(对象)+ effect(allow / ask / deny)。两者都支持 glob:* 任意串、? 单字符,整串匹配。后写的规则覆盖先写的,一条都没命中时默认 ask。

{
  "permissions": [
    { "action": "*", "resource": "*", "effect": "allow" },
    { "action": "shell", "resource": "rm -rf*", "effect": "deny" },
    { "action": "read", "resource": "*.env", "effect": "ask" }
  ]
}

含义:默认全放行;以 rm -rf 开头的 shell 命令硬拒绝;读 .env 文件要确认。「例外」规则写在后面才盖得过前面的 allow。

与 --auto 的关系(均实测):

常见坑:

--wizard(交互式命令引导)

全局 flag,任何子命令后都能加:进入交互式命令构建器(Command wizard),列出可选子命令逐步问答,生成完整命令行。实测 neyino --wizard 与 neyino run --wizard 均可进入,Current command 显示当前已选部分。

neyino --wizard          # 从零构建一条命令
neyino run --wizard      # 以 neyino run 为起点继续补参数

常见坑:

Crew 编排(多会话协作)

把一次任务拆给多名「船员」并行干:Captain(船长)接单拆分 → Chief(部门长)→ Crew(船员)执行,会话列表按角色显示徽章。

记忆(本地长期记忆)

记忆存本地 SQLite,会话中自动注入相关内容;知识图抽取与语义检索由已配置的模型驱动,未配模型时自动降级为词法检索。

Telegram Bot(手机指挥)

neyino bot telegram --token <BotFather 给的 token>

网页控制台(浏览器指挥台)

常见问题

运行提示 "no available models" 或「连接模型服务后才能发送消息」?
还没连接模型:TUI 内输入 /connect(登录 Neyino Console 或粘贴 nyi- 密钥,首次发送时也会自动弹出该窗口),或设置环境变量 NEYINO_API_KEY。连接后 /models 可看到全部模型(含 :free 免费档)。
/wizard 怎么用?
wizard 不是斜杠命令,而是全局参数:任何子命令后加 --wizard(如 neyino run --wizard)会进入交互式命令构建器,逐步问答生成完整命令行。
怎么开始免费用?
连接模型后,模型列表中带 :free 后缀的模型免费(与 API 文档 的免费池同源,均不限量、限速 30 次/分)。付费模型按 token 扣积分,详见 API 文档计费说明。
怎么更新到新版本?
TUI 内 /update,或重跑下载页的安装命令,或 neyino upgrade。
命令太多记不住怎么办?
输入 / 有实时补全;Ctrl+P 打开命令面板(支持搜索);随时 neyino --help 与 neyino <子命令> --help。

相关:下载 · API 接入文档 · 模型广场 · 状态页