monologue-notes

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Monologue Notes

Monologue笔记

Use this skill when an agent needs read-only access to Monologue Notes through the public API.

The current public surface is:

```
GET /v1/public-api/notes
```
```
GET /v1/public-api/notes/{note_id}
```

This skill is intentionally shell-first so it works across agents that can run terminal commands, including Codex and Claude Code.

当Agent需要通过公开API以只读方式访问Monologue笔记时，可使用此Skill。

当前公开的接口包括：

```
GET /v1/public-api/notes
```
```
GET /v1/public-api/notes/{note_id}
```

此Skill优先采用Shell方式实现，因此可在所有能运行终端命令的Agent中使用，包括Codex和Claude Code。

Setup

设置

If the

monologue

CLI is missing, install it:

bash

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

If credentials are not configured yet, run onboarding:

bash

monologue onboarding

During onboarding, ask the user to create a Monologue Notes API token in the Monologue app and paste it into the terminal. The CLI saves it for future use.

For a non-interactive agent flow, the agent can ask the user for the token in chat and then run:

bash

monologue onboarding --token "mono_pat_..."

如果缺少

monologue

CLI，请进行安装：

bash

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

如果尚未配置凭证，请运行引导流程：

bash

monologue onboarding

在引导过程中，要求用户在Monologue应用中创建一个Monologue Notes API令牌，并将其粘贴到终端中。CLI会保存该令牌以供后续使用。

对于非交互式Agent流程，Agent可在对话中向用户索要令牌，然后运行：

bash

monologue onboarding --token "mono_pat_..."

Commands

命令

Use the CLI directly:

bash

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes all --updated-after 2026-01-01T00:00:00Z
monologue notes get note_123
monologue notes get note_123 --field transcript

直接使用CLI：

bash

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes all --updated-after 2026-01-01T00:00:00Z
monologue notes get note_123
monologue notes get note_123 --field transcript

Workflow

工作流程

If the CLI is missing, install it.
If the user is not onboarded yet, run
```
monologue onboarding
```
.
Use
```
list
```
to find relevant notes.
Use
```
all
```
when the request spans more than one page.
Use
```
get NOTE_ID
```
for the full note payload.
Use
```
--field transcript
```
or
```
--field summary
```
when only one field is needed.

如果缺少CLI，请安装它。
如果用户尚未完成引导，请运行
```
monologue onboarding
```
。
使用
```
list
```
命令查找相关笔记。
当请求涉及多页内容时，使用
```
all
```
命令。
使用
```
get NOTE_ID
```
命令获取完整的笔记内容。
当仅需要单个字段时，使用
```
--field transcript
```
或
```
--field summary
```
参数。

Response style

响应风格

Prefer a short digest over raw JSON when the user asks for recent notes or summaries.
Keep
```
note_id
```
internal unless the user explicitly asks for IDs or a follow-up action needs one.
Surface titles, dates, summaries, and transcript highlights first.

当用户请求最新笔记或摘要时，优先返回简短摘要而非原始JSON。
除非用户明确索要ID，或者后续操作需要，否则不对外暴露
```
note_id
```
。
优先展示标题、日期、摘要和文字记录要点。

References

参考资料

Read
```
references/api.md
```
for the exact published schema.
Read
```
references/install.md
```
when the CLI is missing or the environment needs setup help.

如需了解确切的已发布架构，请阅读
```
references/api.md
```
。
当CLI缺失或环境需要设置帮助时，请阅读
```
references/install.md
```
。

Guardrails

约束规则

This skill is read-only. Do not invent create, update, or delete endpoints.

Use ISO 8601 timestamps for

created-after

created-before

, and

updated-after

Prefer the CLI over ad hoc
```
curl
```
so auth, errors, and pagination stay consistent.
Skill installation itself should not be treated as a post-install execution hook. Install the CLI and run onboarding on first use instead.

此Skill为只读模式。请勿虚构创建、更新或删除接口。
对于
```
created-after
```
、
```
created-before
```
和
```
updated-after
```
参数，请使用ISO 8601时间戳。
优先使用CLI而非临时的
```
curl
```
命令，以确保认证、错误处理和分页的一致性。
Skill安装本身不应被视为安装后的执行钩子。请在首次使用时安装CLI并运行引导流程。