笔记 CLI

在设备上运行时没有FreeSyntax账户,网站,或主机后端. 本地模型和提供者密钥是本地配置的 。 GitHub sign-in使用GitHub CLI直接连接到GitHub,而Git操作使用您本地的Git安装并配置了远程. GH_TOKEN 编号 : GITHUB_TOKEN 也认证了 HTTPS GitHub 操作,而不在 Git 配置文件中存储符号 .

您终端的编码助理, 由本地 Ollama 模型或您的 OpenRouter, OpenAI, 或 Anthropic API 键供电 。 不需要主机 Notch 账户或提供者的登录 。 商品支持开发;购买一顶帽子不需要使用CLI.

安装

npm install -g @freesyntax/notch-cli
notch setup
notch doctor
notch

设置提供了提供者和模型选择. 没有被保存的模型的首次互动发布会要求您选择 Up/Down and Enter,然后记住您对该项目的选择. 类型以搜索拾取器中完整的工具能力OpenRouter目录; Escape取消. /model 打开相同的取箭键; /model provider/model 选择精确的模型。 标签完成命令、主题、模型和 @files 在一个有能力的终端。 箭头键保留了拾取器外的正常输入历史. /help 列表命令; /permissions 显示访问选择。 重定向输出和 TERM=dumb 使用纯输出.

使用 notch help 或者说 notch help <command> 在开始会话之前。 设置和密钥菜单使用可搜索箭头导航:上/下移动,上/下页跳过一页,出主/后跳,入选,以及 Esc 或 Ctrl+ C取消计划. 缩写+ U 清除菜单搜索 。 Menus在终端调整规模时会适应. 使用 @"my files/notes.txt" 对于有空格的文件名; Tab 可以完成为引用的文件夹。 多字模式搜索工作为 /models browse --search "gemma 4"。模型菜单中的帮助和无效标记返回会话提示.

GitHub 和 Git 远程

运行 notch github login 用于在支持时安装 GitHub CLI,并通过浏览器签名. notch github status 显示 GitHub 动作所用的账户; notch github repos 列出所有网页上可访问的个人、组织和协作者存放处。 IDE使用相同的GitHub CLI登录. GH_TOKEN 优先于 GITHUB_TOKEN,而且两者都覆盖已保存的证书。 在切换到浏览器登录前, 更新或删除环境符号 .

对于已有的 Git 工程, 请使用 git remote -v连接缺失的远程 git remote add origin <repository-url>。Git 使用您现有的 HTTPS 证书助手或 SSH 密钥;普通 Git 远程不需要 GitHub 签名。 还需要一个新的存储库 git init 以及 Git 作者姓名和电子邮件 .

光标来源

运行 notch origin login 并打开浏览器中打印的光标签名链接。 在Windows上,官方的Cursor SDK在本地处理浏览器登录;CLI和IDE共享一个被Windows DPAPI保护的登录,供当前用户使用. 不需要WSL或FreeSyntax服务. 使用 notch origin repos 以列表可访问寄存器,然后 notch origin clone owner/repo。粘贴 HTTPS 和 SSH URL 保存协议;使用 --protocol ssh 与所有者/ repo 一起选择 SSH.

运行 notch origin pull --cwd ./repo 财务报告和审定财务报表 notch origin push --cwd ./repo 承诺的变化。 拉力只允许快进;从不推力. 都检查配置 origin 连接远程器前的 URL 。 拒绝的推动 保持你的当地承诺。 要解决历史的分歧,请使用正常的 Git 工作流程 。 这些命令不会创建承诺、 舞台文件、 重写远程或配置 SSH 信任 。 用 Origin 注册一个 SSH 公钥,并在第一次 SSH 连接前验证其正式主机指纹 .

打开 窗口,签入,寄存器列表,克隆,拉出和推出使用本地Windows进程和路径. HTTPS (韩语) Git通过一个被主机扫描的认证帮助获得短寿命的Origin访问符;证书从未被写入寄存器URL或Git配置文件. SSH 使用您的注册本地密钥 . --native 继续接受兼容性. --distribution Ubuntu 如果您选择了 WSL 工作流程,则明确选择使用该工作流程.

macOS和Linux使用土生土长的Git和正式的Origin CLI. Origin需要符合条件的光标账户; GitHub sign- in 不认证Origin. 个人 CURSOR_API_KEY 值在 Cursor 所记录的符号终点交换; CURSOR_AUTH_TOKEN 已经是一个无记名标志。 环境证书优先于所保存的登录。 API密钥从未作为无记名符号直接被发送到Origin. notch origin logout 删除已保存的本地登录; 在 Cursor 的仪表板中也可以被吊销 .

在一个会话内,使用 /origin login, (中文(简体) ), /origin repos, (中文(简体) ), /origin clone owner/repo "folder with spaces", (中文(简体) ), /origin pull 财务报告和审定财务报表 /origin push标签完成这些命令; /origin --help 列表选项。 Ctrl-C取消活动子命令并恢复会话输入. 以下为来源认证 Cursor 的官方 CLI 文件, (中文(简体) ), 命令引用 财务报告和审定财务报表 Git/SSH 文档。 。 。 .

测试涵盖真实的本地 Git Clone/pull/push 和被拒绝的推,URL/参数验证,既包括执行模式,也包括证书编辑. Live Cursor 托管的账户认证和写作需要一个Origin 启用的账户,没有一个账户就无法核实.

要求notch在发布前承诺并推进对文件和目的地进行审查. 敏感文件路径,包括重命名的两侧,都被排除在此合并动作之外. 现有的承诺分支即使没有上游部门也可以出版. /pr 在创建 GitHub 拖取请求之前推动当前承诺, 并使用寄存器的实际默认分支 。 Git工具阻止了向受保护或模棱两可的目的地推进的力量.

下载并运行本地模式

notch models
notch models browse --search gemma
notch models browse --search gemma --page 1 --json
notch models recommend --json
notch models install --runner ollama --model unsloth/Qwen3.5-4B-GGUF --yes --no-launch
notch
notch models unload

notch models 使用可用的RAM提供编号为Hugging Face的选择并检测出专用的GPU内存,包括Windows AMD GPU. 苹果统一内存计算一次. 选择按寄存器创建日期排序;该日期并不确定模型质量. 公共模型大小和元数据被缓存6小时,缓存下载被再用. 内存估计预留加载/文本头室;安装者在替换项目选择前加载模型并检查无害的本地工具呼叫及其结果往返. 失败的检查保留了上一个选择 .

每个运行时间都使用被选中的模型的活化器和聊天格式. 被导入的GGUF架构/模板元数据为Gemma4,Quen3.5,Quen3-Coder和GLM4.7选择经验证的本地Ollama工具配置;其他模型保留了嵌入的运行时模板. 原生上下文限制来自所导入的Ollama模型或特定版本的MLX配置,而不是寄存器名. 飞行前的票证估计数仍然大致相同;实际使用数来自供应商。 任意存储器可能缺乏相容的工具支持和失败验证.

浏览并安装搜索Hugging Face的公用兼容目录,而不是在3个建议下停止. Ollama选择需要可核查的Q4 K M GGUF重量;Apple MLX选择需要安全器. 搜索包括聊天和编码转换;安装时会检查工具支持. --page 在浏览了前一页之后, 沿着Hub的下一页链接 --refresh 刷新缓存结果 。 安装提示接受一个模型编号, n编号 :p 更改页面, s 搜索,和 q 将取消。 选择在下载前刷新元数据和可用记忆估计 。 离线未过滤浏览可以以警告显示已保存的 Quen 推荐; 新的搜索不会默默地替代无关的模型 。 您仍然可以指定一个公共寄存器 --model。 。 。 .

Quen3.5 4B Hugging Face模型在被测试的Windows机器上完成了全部三个本地编码检查,时间为16K上下文 / 第64批. 这个小套房不是一般质量基准.

安装后 Ollama 开始本地化 。 如果对所选模型来说它缺席或太老了, Notch会下载一个相容的官方运行时间,验证其SHA-256摘要,并单独运行于 127.0.0.1:11436. 现有装置仍然可用。 这个第一次下载可以超过 1 GiB;模型重是额外的下载. 被引导安装器为项目保存被测量的上下文/批选. /models install, (中文(简体) ), /models recommend, (中文(简体) ), /models status 财务报告和审定财务报表 /models unload 也可在《国家行动倡议》内查阅.

苹果硅麦克斯(M1或更新型,macOS 14+)可以选择 MLX(β) 语言 或者奥拉玛 MLX需要本地的ARM64 Python 3.11+; CLI 安装 mlx-lm 在自己的用户环境中,将权重下载到Hugging Face缓存中。 Python,MLX和模型重被单独下载,而不是被捆绑在npm包中. MLX在回放上收听,由运行中的Notch会话所拥有. 退出会话或使用 /models unload 以释放记忆。 MLX有平台/protocol测试,但没有为这个发布在苹果硬件上进行测试.

--no-launch 验证一个安装并卸下它。 非交互式安装也在之后卸下. 正在卸载释放模型内存并持续下载文件. Ollama守护进程仍可被闲置再利用. 初始下载需要网络访问和自由磁盘空间;在安装前显示模型许可证.

Colibri(实验)

Colibri从所选择的检查站和模型家族中选择其标定器并支持聊天模板. 管理发射从其他模型中分离出指示器,模板和停止键设置.

新 Colibri 设置使用 16K 上下文为编码工具和对话留有空间. 装入仍然需要足够的当前自由内存;现有的明确上下文选择被保留.

选择 Colibri 当您想要尝试磁盘流混合专家模型时 。 Ollama 仍然是默认。 设置需要64位Python 3.10+并下载一个孤立的,检查和校验的引擎;全球没有安装Python包.

notch models install --runner colibri
notch models recommend --runner colibri --json
notch models status --runner colibri
notch models unload --runner colibri

安装菜单支持箭头键并搜索. 它显示当前可用的RAM,安全储备,下载大小,最小/推荐的RAM和磁盘限制在确认前. 无法通过设置下载自由记忆预检查的模型 。 通过这一初步估计无法证实该模型将在16K上下文运行:准确的检查点和上下文在下载后和装入前都会被检查. 关闭应用程序后重新运行以刷新内存 。 中断后恢复下载 。 设置在更改您的工程选择之前验证一个无害的工具调用及其结果 . /model 包括经审定的模型; /context limit 卸下后更改上下文. /models unload 释放活动 Colibri 模式,同时保留其重量.

Colibri是可选的下载,不以npm捆绑. 它目前支持Windows x64,Linux x64和苹果硅. 大型模型在第一个符号之前可以有很长的等待时间;安装入内存并不能建立有用的编码速度. 模型重量有自己的许可证。 这种实验性整合开始一个对话槽并共享noch的本地推论队列.

Colibri的重量已经转换了吗? 导入它们 notch models install --runner colibri --model-dir /path/to/model. GGUF 文件用于Ollama,不能作为 Colibri 容器导入.

浏览 OpenRouter

notch models openrouter
notch models openrouter --search gemma --json
notch models openrouter --page 1
notch models coding --search coder

OpenRouter浏览使用没有API密钥的完整的公用文本模型目录. 平面输出显示每页20个模型; --json 包括每个匹配行,上下文大小,价格和工具支持. coding 将结果限制在模型广告工具上. 仅聊天模式在一般浏览中仍然可见有原因;编码取取取者将其排除在外. 运行云模型仍需要经过验证的API密钥. 结果被缓存了6小时; --refresh 绕过缓存,并明确标出离线后退. /models openrouter --search gemma 财务报告和审定财务报表 /models browse --search gemma 在运行的会话中工作.

命令、服务器和检查

Notch 执行工具调用顺序,并在响应中跳过重复调用. 一个不变的失败动作最多运行了两次,然后notch停止了重试循环. 成功的改变允许再次尝试.

对于本地开发服务器,请 Notch 使用 shell 与 background: true它返回进程ID和日志路径。 启动一个进程不会验证一个网站是否准备好;notch必须单独检查其端点. 测试在前景中运行,所以它们的退出状态是可用的.

失败检查会记录到同一命令成功为止 。 失败的检查不能被模型的最终措辞变为成功完成. 无头运行退出状态 2 并报告 verification-failed 或者说 stalled 在适当情况下。 此检查命令执行结果; 无法证明测试套件涵盖了每一项要求 .

自动更新

Global npm 安装在每个交互式代理启动上检查选中的 npm 通道 。 当有更新的版本可用时,Notch在开启会话前会用相同的参数安装并重启. 登记处在5秒后检查停工时间;离线或许可故障报告问题并继续使用当前版本。 更新时没有激活的对话 .

--no-update 或者说 NOTCH_AUTO_UPDATE=0 禁用这个 . --update-channel latest|next|beta 覆盖 NOTCH_UPDATE_CHANNEL,保存的频道和默认 latest 频道. notch update 强制进行人工更新; notch update --check 检查没有安装。 源检出,本地项目安装,npx缓存,JSON/无头运行,帮助/版本和发现命令不会自动安装全局更新.

运行此检出

使用"节点"(Node.js 22.19)或"更新"和"Git"(Node.js 24 LTS测试). 从 notch-cli数字 :

npm ci --workspaces=false
npm run build
node dist/index.js setup
node dist/index.js doctor
node dist/index.js "Explain this repository"

npm link --workspaces=false 将此项取出作为 notch。 。 。 .

当地奥拉马

安装/启动 奥拉玛,然后用工具支持拉出一个模型. qwen3-coder:30b 完成了此机上的 三任务本地编码评价; 它需要的内存比小聊天模式要多得多 :

ollama pull qwen3-coder:30b
notch setup --provider ollama --model qwen3-coder:30b
notch doctor
notch "Read the failing test, fix the implementation, and run the test"

设置已安装的列表模型、 检查工具能力和写入 .notch.json 在当前项目中。 本地 Ollama 不需要 API 密钥 。 模型质量决定了编码质量. qwen3:4b 也经过了测试,但大部分编码评价都失败了,并不是对自主更改的可靠默认. 三项任务是行为检查,而不是一般的基准.

OLLAMA_HOST 或者说 notch setup --host http://localhost:11434 选择不同的守护进程。 几乎没有主机, /api 财务报告和审定财务报表 /v1 后缀归正. 请求使用本地 /api/chat 因此上下文大小是明确的,而不是继承一个可能不充分的守护进程默认值. NOTCH_OLLAMA_CONTEXT 默认为 8192 个令牌( 允许使用 2048 – 262144 个) , 并被夹入已验证的本地模式限制; 选择一个大小, 由您的模式和可用的 RAM/ VRAM 支持 。 较大的上下文需要更多的内存. NOTCH_OLLAMA_THINK=0 请求禁用支持它的模型.

notch ollama list, (中文(简体) ), status, (中文(简体) ), pull <model>,以及 launch --model <model> 继续提供. launch 保存选择; 运行 notch 后结. 非交互设置从不默默地下载一个模型.

NOTCH_OLLAMA_BATCH 设置 Ollama 的批量大小( 默认 64; 整数 1– 2048) 。 更小的批量可以以即时处理速度为代价来减少临时GPU内存的使用. 测量硬件上的模型/文本/批次组合,而不是假设更大的模型适合.

起步横幅显示有效的上下文和批量大小. /context 显示当前限制; /context limit 打开箭键菜单,并 /context 16384 设定精确的当地奥拉马限值。 为工程保存设置, 并在下一个请求时生效 . NOTCH_OLLAMA_CONTEXT,如果设定,则覆盖这些工程设置;在通过 CLI 更改限制之前取消设置。 托管供应商执行自己的模式限制.

在测试机上,需要30B型 NOTCH_OLLAMA_CONTEXT=16384 财务报告和审定财务报表 NOTCH_OLLAMA_BATCH=64; 32K上下文已耗尽了GPU内存. 如果适合您的硬件, 在启动 Notch 之前设定这些环境变量 。 当完成时, ollama stop qwen3-coder:30b 在保留下载的同时释放模型内存.

打开路透社

OpenRouter使用其所维护的AI SDK适配器进行流调和工具调用,包括一些模型在工具结果后继续时所需的推理元数据. 核对兼容性 OpenRouter 官方整合指南, (中文(简体) ), 流媒体格式 财务报告和审定财务报表 推理文件,带有本地协议固定装置,而不是付费推断.

notch setup --provider openrouter
notch doctor
notch "Fix the failing tests"

设置向导显示当前的OpenRouter编码模型目录,并提供被遮掩的API-key条目. 密钥存储在用户证书存储处,而不是项目配置. 或设置 OPENROUTER_API_KEY 在环境和使用中 notch setup --provider openrouter --model <provider/model>。 。 。 .

OpenRouter 的用法被记入您的 OpenRouter 账户 。 设置验证认证,模型可用性和工具支持;它不发送可计费编码请求. 目前的型号ID来自提供商目录,而不是本README中的固定建议.

OpenAI 和 Anthropic 数据

notch setup --provider openai
notch setup --provider anthropic

设定 OPENAI_API_KEY 或者说 ANTHROPIC_API_KEY,或将您的密钥粘贴到隐藏的设置提示中。 OpenAI使用原生反应API;Anthropic使用原生消息API. 设置检查模式访问,而不产生可收费的答复. 多工作空间 Athropic 键可能需要 ANTHROPIC_WORKSPACE_ID. API的使用与ChatGPT或克洛德订阅分开计费. 使用开发者 API 证书; Notch 不接受 Claude 订阅令牌或收集提供者的登录会话. OpenAI API 认证, (中文(简体) ), 道德认证政策。 。 。 .

自动化和覆盖

notch --cwd /path/to/repo --provider ollama --model qwen3:4b "Explain the tests"
notch --json --provider openrouter --model <provider/model> "Review the changes"
notch doctor --json

明确的CLI提供者/模型选项凌驾于环境和项目选择之上. 更换供应商可以清除陈旧的供应商证书和终点。 使用 --base-url 仅当故意压倒选定的提供者终点时. --no-repo-map 跳过自动仓库映射,以及 --no-markdown 禁用Markdown渲染 .

--json 发布JSONL事件。 致命模型/运输故障返回非零退出代码. 仍然适用工具权限; --trust 自动批准工具操作,并且只能用于您打算允许这些操作的工作空间。 现有的恢复、检查站、许可证管制、项目指示和多边方案支助仍然通过 notch --help。 。 。 .

访问配置文件

本地 Ollama/MLX 生成请求使用相同的操作系统用户/家目录共享一个可切换的可切换CLI和IDE进程队列. OpenRouter请求可以并行运行. 等待任务显示其状态; Ctrl+C 取消当前 CLI 回合 。 槽在工具或批准前被放出,因此工人不能让父母陷入僵局. 一个被杀死的进程的队列条目会被自动回收 。 使用运行时间的其他应用程序不加入此队列 .

任务直接在您的 默认项目文件夹可书写转弯跨越非CLI和IDE进程,包括空壳命令和工人。 只读的云任务仍然可以并行运行. 使用 /settings 或者说 /workspace 为箭键菜单, /workspace shared 用于项目文件夹,或 /workspace isolated 为平行的 OpenRouter 工作树。 选择被保存在 .notch.json 作为 workspaceMode· ; notch config set workspaceMode isolated 财务报告和审定财务报表 --workspace-mode isolated 还有工作 地方任务总是轮流进行.

在孤立模式下, 可写 OpenRouter 任务使用私有 Git 工作树包括他们的终端命令和可写字的工人。 不需要设置或分支切换 。 您的相机编辑、 工作文件和未跟踪输入都会被复制而无需更改分支或索引 。 必须安装 Git; 非 Git 文件夹使用私人 Git 数据库而不初始化您的工程 。 忽略的依赖和构建输出不共享;一个任务可以安装自己的依赖.

当任务完成后安全更改自动返回您的项目, 包括终端创建的文件, 并在 Undo 中记录 。 如果另一个任务或编辑器更改了同一个文件,则整个发送会保持分开. 请 Notch 调和; 代理可以使用 task_changes 在更新其私人文件之前。 中断的任务恢复保存的退出 。 已完成的结账自动被删除;冲突或未完成的工作保留在 ~/.notch/worktreesJSONL 包括: workspace-result 事件和一个会话ID; 发送冲突返回退出代码 2.

共享的 MCP 服务器,插件和命令钩被禁用用于孤立的任务,因为它们可能保留另一个工作空间的路径. 共同承担的任务保留现有的整合。 内建文件工具拒绝在任务检出外写入,并在其中进行 steal 编辑. Worktree将普通命令分开,但不是一个操作系统沙盒:有明确外部路径的任意代码仍然可以访问您的账户文件. 符号-链接/子模块输入安全失败;当Undo无法录入时,二进制输出仍留在了私人取出中. 文件工具和Undo继续协调本地编辑,但外部编辑者不参与noch的锁.

notch --access approve "Review the change"
notch --access read-only "Plan the refactor"
notch --access full-access "Implement and test the change"
notch --dry-run "Show the proposed edits"

approve 使用您配置的允许/任务/密度规则,并在需要批准的工具前询问;空答案或关闭输入拒绝。 无头电话拒绝使用即时级工具,除非您明确允许访问或使用现有的 --yes 选项. read-only 允许内置文件/搜索/网络读取并否认其他工具,即使许可规则允许它们. full-access 授予工具访问权,无需许可; --trust 是它的别名 设定 accessMode 内 .notch.json 或者说 NOTCH_ACCESS_MODE 选择默认; 明示 --access 超过它.

干跑预览可能改变状态的工具,包括MCP/plugin和工人执行. /dry-run 交互切换; /sandbox 仍为别名. 访问剖面图和干跑是受用控制,而不是OS隔离CLI,钩子,插件或子进程. 见 发行准备情况审计 用于剩余的执行后端工作.

切换运行中配置文件 /permissions approve, (中文(简体) ), /permissions read-only,或 /permissions full-access; 此项目的选择被保存. /strict 完全访问后恢复批准。 Ctrl-C取消当前转弯,包括它的本地 shell 进程树. 转弯时输入的命令按顺序处理.

/undo 恢复由内建写入、编辑和补丁工具捕获的最新变化。 在重新启动后幸存的检查点: 使用 /resume 或者说 notch --session <id> 然后重开已保存的会话 /undo。随后的手工编辑、更改的工作空间和链接文件都受到保护。 失败或被取消的转会保留被捕获的编辑; 被崩溃中断的未验证的写入被屏蔽检查 。 外壳,插件和外置更改没有被捕获,因此保留了Git中的项目. 历史被私下保存在 ~/.notch/undo 每会话有64个 MiB 限制;如果达到这个限制,则开始新的会话。 在无头模式中,达到重复限制返回的退出代码2和a session-end 现况 max-iterations。 。 。 .

校验

Windows源代码构建还需要 Rust(MSVC工具链)和Visual Studio C++为用户创建工具 硬件探测器。安装的 npm 包包括可执行文件;终端用户不需要 Rust .

npm run typecheck
npm test
npm run build

见 执行情况研究和核查 现场测试证据和当前限制.

网络研究

请 Notch 搜索当前文档并引用来源 . DuckDuckGo 是默认的,不需要安装 API 密钥或浏览器,包括当地模式。 打开 /settings web · 选择搜索提供者,或运行 notch web,选择 DuckDuck Go 或可选 塔维利。对于 Tavily, 在同一菜单或设置中添加一个密钥 TAVILY_API_KEY。保存或环境密钥不会自动切换提供者。 不需要帐号 .

Duck Duck Go 来用它吧 公开 HTML 搜索它可以限制收费要求或要求进行人力核查;不报告这种情况,而不是创造结果或默不作声地转向有偿服务。 稍后再试或选择塔维利. 结果出自第一搜索页,所以请求的结果计数是最大,而不是保证.

web_fetch 读取已知的 HTTP( S) URL 而无需搜索密钥 . browser_read javaScript 页面使用真实浏览器. browser_interact 打开一个 URL,并在读取结果前执行最多八次点击/填充/选择/按下步骤。 每次浏览器调用都会使用新的私人会话;cookie和登录会话不会在调用之间持续. 浏览器交互使用正常的任务批准政策,无法以只读模式使用.

自动使用安装的边缘或克罗姆. 选择浏览器或安装 Chromium 在 /settings web,或运行 notch web install-browser。下载是明确的;浏览器工具从不默默地安装软件. notch web status 显示设置而不显示您的密钥 。 在同一设置中禁用 Web 研究以阻止这些内置的网络工具.

来源包括可点击的Markdown链接和检索时间. 终端输出还打印了支持的可见源 URL和超链接. 搜索查询到您选定的搜索提供者,页面请求到访问的网站,包括当您的语言模式为本地时。 CLI 搜索密钥被保存在您带有限制性文件权限的每个用户notch配置中, 在项目外; 如果您不想保存密钥, 请使用环境变量 .