blooming-blockery-cli

Use this skill to run

block

sub-commands of

blooming-blockery

correctly, and understand the

blooming-blockery

CLI structure.

使用本技能来正确运行

blooming-blockery

的

block

子命令，同时了解

blooming-blockery

的CLI结构。

When to use

适用场景

The user asks how to use
```
blooming-blockery
```
or
```
block
```
from terminal scripts.
The user hits CLI parsing errors with block IDs, mount formats, or panel states.
The user needs ready-to-copy command examples for block store workflows.
The user is scripting interactions with the block document store.

用户询问如何在终端脚本中使用
```
blooming-blockery
```
或
```
block
```
命令。
用户遇到block ID、挂载格式或面板状态相关的CLI解析错误。
用户需要可直接复制的块存储工作流命令示例。
用户正在编写与块文档存储交互的脚本。

Global Flags

全局标志

All commands support these global flags:

```
--store <PATH>
```
: Path to the block store file (defaults to app data file)
```
--verbose
```
: Enable verbose output (currently reserved)
```
--output <FORMAT>
```
: Output format -
```
table
```
(default) or
```
json
```

所有命令都支持以下全局标志：

```
--store <PATH>
```
：块存储文件的路径（默认使用应用数据文件）
```
--verbose
```
：启用详细输出（目前为预留功能）
```
--output <FORMAT>
```
：输出格式 -
```
table
```
（默认）或
```
json
```

Block ID Format

Block ID格式

Block IDs use a clean format like

1v1

,

2v3

where:

First number = slot index in the store
```
v
```
= separator
Second number = generation counter (increments on reuse)

Block ID采用简洁的格式，例如

1v1

、

2v3

，其中：

第一个数字 = 存储中的槽位索引
```
v
```
= 分隔符
第二个数字 = 生成计数器（复用块时会递增）

Command Reference

命令参考

All the following commands should be prepended by

blooming-blockery

.

所有以下命令都需要添加

blooming-blockery

前缀。

Query Commands

查询命令

bash

undefined

bash

undefined

List all root block IDs

block roots block roots --output json

Show block details

block show <BLOCK_ID> block show 1v1 --output json

Search blocks by text (case-insensitive substring)

block find "search query" block find "TODO" --limit 10

Edit the text content of a block

block point <BLOCK_ID> "New text content" block point 1v1 "Updated text"

undefined

block point <BLOCK_ID> "New text content" block point 1v1 "Updated text"

undefined

Tree Structure Commands

树结构命令

bash

undefined

bash

undefined

Add child block under parent (parent must not be a mount)

block tree add-child <PARENT_ID> "Text content" block tree add-child 1v1 "My new idea"

Add sibling after a block

block tree add-sibling <BLOCK_ID> "Text content" block tree add-sibling 1v1 "Next sibling"

Wrap a block with a new parent

block tree wrap <BLOCK_ID> "Parent text" block tree wrap 1v1 "New parent section"

Duplicate a subtree

block tree duplicate <BLOCK_ID> block tree duplicate 1v1

Delete a subtree (removes block and all descendants)

block tree delete <BLOCK_ID> block tree delete 1v1

Move block relative to target

block tree move <SOURCE_ID> <TARGET_ID> --before block tree move <SOURCE_ID> <TARGET_ID> --after block tree move <SOURCE_ID> <TARGET_ID> --under

undefined

block tree move <SOURCE_ID> <TARGET_ID> --before block tree move <SOURCE_ID> <TARGET_ID> --after block tree move <SOURCE_ID> <TARGET_ID> --under

undefined

Navigation Commands

导航命令

bash

undefined

bash

undefined

Get next visible block in DFS order

block nav next <BLOCK_ID> block nav next 1v1

Get previous visible block

block nav prev <BLOCK_ID> block nav prev 2v1

Get lineage (ancestor chain)

block nav lineage <BLOCK_ID> block nav lineage 1v1

undefined

block nav lineage <BLOCK_ID> block nav lineage 1v1

undefined

Draft Commands (LLM suggestions)

草稿命令（LLM 建议相关）

bash

undefined

bash

undefined

Set expansion draft (rewrite + proposed children)

block draft expand <BLOCK_ID> --rewrite "Refined text" --children "Child 1" "Child 2" block draft expand 1v1 --children "Just kids"

Set reduction draft (condensed version)

block draft reduce <BLOCK_ID> --reduction "Condensed text" --redundant-children 2v1 3v1

Set instruction draft (user-authored LLM instructions)

block draft instruction <BLOCK_ID> --text "Make this more concise"

Set inquiry draft (LLM response to ask query)

block draft inquiry <BLOCK_ID> --response "The key insight is..."

List all drafts for a block

block draft list <BLOCK_ID>

Clear drafts (use --all or specific flags)

block draft clear <BLOCK_ID> --all block draft clear <BLOCK_ID> --expand block draft clear <BLOCK_ID> --reduce --instruction

undefined

block draft clear <BLOCK_ID> --all block draft clear <BLOCK_ID> --expand block draft clear <BLOCK_ID> --reduce --instruction

undefined

Fold (Collapse) Commands

折叠命令

bash

undefined

bash

undefined

Toggle fold state

block fold toggle <BLOCK_ID>

Get fold status

block fold status <BLOCK_ID>

undefined

block fold status <BLOCK_ID>

undefined

Friend (Cross-reference) Commands

关联（交叉引用）命令

bash

undefined

bash

undefined

Add friend block with optional perspective

block friend add <TARGET_ID> <FRIEND_ID> --perspective "Related design" block friend add <TARGET_ID> <FRIEND_ID> --telescope-lineage --telescope-children

Remove friend

block friend remove <TARGET_ID> <FRIEND_ID>

List friends

block friend list <TARGET_ID>

undefined

block friend list <TARGET_ID>

undefined

Mount (External File) Commands

挂载（外部文件）命令

bash

undefined

bash

undefined

Set mount path (block must be leaf, no children)

block mount set <BLOCK_ID> <PATH> [--format json|markdown] block mount set 1v1 /data/external.json block mount set 1v1 /notes/notes.md --format markdown

Expand mount (load external file)

block mount expand <BLOCK_ID>

Collapse mount (remove loaded blocks, restore mount node)

block mount collapse <BLOCK_ID>

Extract subtree to external file

block mount extract <BLOCK_ID> --output <PATH> [--format json|markdown] block mount extract 1v1 --output /backup/notes.json

Show mount info

block mount info <BLOCK_ID>

undefined

block mount info <BLOCK_ID>

undefined

Panel Commands

面板命令

bash

undefined

bash

undefined

Set panel state

block panel set <BLOCK_ID> friends block panel set <BLOCK_ID> instruction

Get panel state

block panel get <BLOCK_ID>

Clear panel state

block panel clear <BLOCK_ID>

undefined

block panel clear <BLOCK_ID>

undefined

Context Command

上下文命令

bash

undefined

bash

undefined

Get LLM context for a block (lineage, children, friends)

block context <BLOCK_ID> block context 1v1

undefined

block context <BLOCK_ID> block context 1v1

undefined

Common Error Patterns

常见错误类型

```
UnknownBlock
```
: Block ID not found in store
```
InvalidOperation
```
:
- Parent is a mount (cannot add children)
- Source is ancestor of target (cycle in move)
- Block has children (cannot set mount)
- Attempting to add self as friend
```
IoError
```
: Failed to read/write mount file

```
UnknownBlock
```
：存储中未找到对应Block ID
```
InvalidOperation
```
：
- 父块是挂载块（无法添加子块）
- 源块是目标块的祖先（移动操作会产生循环）
- 块存在子块（无法设置挂载）
- 尝试将自身添加为关联块
```
IoError
```
：挂载文件读/写失败

Tips

提示

Use
```
--output json
```
for scripting and parsing results
Block IDs are case-insensitive
Mount format defaults to
```
json
```
but supports
```
markdown
```
Panel states are
```
friends
```
or
```
instruction
```
The GUI launches by default if no subcommand is given

编写脚本和解析结果时使用
```
--output json
```
参数
Block ID不区分大小写
挂载格式默认为
```
json
```
，也支持
```
markdown
```
面板状态可选值为
```
friends
```
或
```
instruction
```
如果不输入任何子命令，默认会启动GUI

blooming-blockery-cli

Original

Translation

blooming-blockery-cli

blooming-blockery-cli

When to use

适用场景

Global Flags

全局标志

Block ID Format

Block ID格式

Command Reference

命令参考

Query Commands

查询命令

List all root block IDs

List all root block IDs

Show block details

Show block details

Search blocks by text (case-insensitive substring)

Search blocks by text (case-insensitive substring)

Edit the text content of a block

Edit the text content of a block

Tree Structure Commands

树结构命令

Add child block under parent (parent must not be a mount)

Add child block under parent (parent must not be a mount)

Add sibling after a block

Add sibling after a block

Wrap a block with a new parent

Wrap a block with a new parent

Duplicate a subtree

Duplicate a subtree

Delete a subtree (removes block and all descendants)

Delete a subtree (removes block and all descendants)

Move block relative to target

Move block relative to target

Navigation Commands

导航命令

Get next visible block in DFS order

Get next visible block in DFS order

Get previous visible block

Get previous visible block

Get lineage (ancestor chain)

Get lineage (ancestor chain)

Draft Commands (LLM suggestions)

草稿命令（LLM 建议相关）

Set expansion draft (rewrite + proposed children)

Set expansion draft (rewrite + proposed children)

Set reduction draft (condensed version)

Set reduction draft (condensed version)

Set instruction draft (user-authored LLM instructions)

Set instruction draft (user-authored LLM instructions)

Set inquiry draft (LLM response to ask query)

Set inquiry draft (LLM response to ask query)

List all drafts for a block

List all drafts for a block

Clear drafts (use --all or specific flags)

Clear drafts (use --all or specific flags)

Fold (Collapse) Commands

折叠命令

Toggle fold state

Toggle fold state

Get fold status

Get fold status

Friend (Cross-reference) Commands

关联（交叉引用）命令

Add friend block with optional perspective

Add friend block with optional perspective

Remove friend

Remove friend

List friends

List friends

Mount (External File) Commands

挂载（外部文件）命令

Set mount path (block must be leaf, no children)

Set mount path (block must be leaf, no children)

Expand mount (load external file)

Expand mount (load external file)

Collapse mount (remove loaded blocks, restore mount node)