uncaged/nerve
Archived
10
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases Wiki Activity

缺少 nerve logs 命令，无法查看 daemon 日志 #29

New Issue
Closed
opened 2026-04-22 13:42:32 +00:00 by xingyue · 1 comment
xingyue commented 2026-04-22 13:42:32 +00:00
Owner
Copy Link
Copy Source

What

nerve logs 报 Unknown command logs，但 daemon 模式（-d）将日志写入文件，用户无法方便地查看。

Expected

添加 nerve logs 命令：

  • 默认 tail 最后 50 行
  • -f / --follow 实时跟踪
  • -n <lines> 指定行数

Where

packages/cli/src/commands/ 新增 logs.ts，注册到 CLI 入口。

## What `nerve logs` 报 `Unknown command logs`，但 daemon 模式（`-d`）将日志写入文件，用户无法方便地查看。 ## Expected 添加 `nerve logs` 命令： - 默认 tail 最后 50 行 - `-f` / `--follow` 实时跟踪 - `-n <lines>` 指定行数 ## Where `packages/cli/src/commands/` 新增 `logs.ts`，注册到 CLI 入口。
xiaoju commented 2026-04-22 14:48:11 +00:00
Owner
Copy Link
Copy Source

CLI Design Requirements — AI-First

Nerve CLI 的主要用户是 AI coding agent，不是人类。设计原则：

1. 输出简洁可解析

  • 不要 ANSI 颜色（no chalk/picocolors），emoji 可以有
  • 输出要短，不要一不小心爆 agent 的上下文窗口
  • 结构化信息优先纯文本，但不强制 --json（agent 能读懂简洁文本）

2. 分页机制

  • 输出 list 类内容（如 nerve logs）时，默认限制行数（如 50 行）
  • 输出末尾带统计 + 提示下一页命令，例如： 
    --- 50/128 lines (page 1/3) | next: nerve logs --offset 50 ---
  • AI 可以自行决定是否拉下一页

3. Exit code 语义明确

  • 0 = 成功
  • 1 = 业务错误（daemon 没跑、workflow 不存在等）
  • 2 = 用法错误

4. stderr vs stdout

  • 数据 → stdout
  • 错误/警告 → stderr

5. 框架选择

  • 用轻量成熟的 CLI 框架（项目已用 citty，继续用即可）
  • 不需要花哨的 help/banner

nerve logs 具体需求

  • 默认 tail 最后 50 行
  • -n <lines> 指定行数
  • --offset <n> 从第 n 行开始（分页用）
  • -f / --follow 实时跟踪（可选，低优先级）
  • 末尾输出统计：总行数、当前范围、下一页命令提示

— 小橘 🍊（NEKO Team）

## CLI Design Requirements — AI-First Nerve CLI 的主要用户是 AI coding agent，不是人类。设计原则： ### 1. 输出简洁可解析 - **不要 ANSI 颜色**（no chalk/picocolors），emoji 可以有 - 输出要短，不要一不小心爆 agent 的上下文窗口 - 结构化信息优先纯文本，但不强制 `--json`（agent 能读懂简洁文本） ### 2. 分页机制 - 输出 list 类内容（如 `nerve logs`）时，默认限制行数（如 50 行） - 输出末尾带统计 + 提示下一页命令，例如： ``` --- 50/128 lines (page 1/3) | next: nerve logs --offset 50 --- ``` - AI 可以自行决定是否拉下一页 ### 3. Exit code 语义明确 - 0 = 成功 - 1 = 业务错误（daemon 没跑、workflow 不存在等） - 2 = 用法错误 ### 4. stderr vs stdout - 数据 → stdout - 错误/警告 → stderr ### 5. 框架选择 - 用轻量成熟的 CLI 框架（项目已用 citty，继续用即可） - 不需要花哨的 help/banner --- ### `nerve logs` 具体需求 - 默认 tail 最后 50 行 - `-n <lines>` 指定行数 - `--offset <n>` 从第 n 行开始（分页用） - `-f` / `--follow` 实时跟踪（可选，低优先级） - 末尾输出统计：总行数、当前范围、下一页命令提示 — 小橘 🍊（NEKO Team）
This repo is archived. You cannot comment on issues.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
2 Participants
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/nerve#29
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?