docs: Clarify gt mol vs bd mol command distinction
Update reference.md to explain the separation: - bd mol: beads data operations (list, show, pour, wisp, bond) - gt mol: agent operations (status, current, attach, burn, squash) Key clarification: gt mol burn/squash operate on current agent's attached molecule (auto-detected), while bd mol burn/squash take explicit molecule IDs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -121,22 +121,47 @@ persisted to JSONL. They exist only in memory during execution.
|
|||||||
|
|
||||||
## Molecule Commands
|
## Molecule Commands
|
||||||
|
|
||||||
|
**Principle**: `bd` = beads data operations, `gt` = agent operations.
|
||||||
|
|
||||||
|
### Beads Operations (bd)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Formulas
|
# Formulas
|
||||||
bd formula list # Available formulas
|
bd formula list # Available formulas
|
||||||
bd formula show <name> # Formula details
|
bd formula show <name> # Formula details
|
||||||
bd cook <formula> # Formula → Proto
|
bd cook <formula> # Formula → Proto
|
||||||
|
|
||||||
# Molecules
|
# Molecules (data operations)
|
||||||
bd mol list # Available protos
|
bd mol list # Available protos
|
||||||
bd mol show <id> # Proto details
|
bd mol show <id> # Proto details
|
||||||
bd mol pour <proto> # Create mol
|
bd mol pour <proto> # Create mol
|
||||||
bd mol wisp <proto> # Create wisp
|
bd mol wisp <proto> # Create wisp
|
||||||
bd mol bond <proto> <parent> # Attach to existing mol
|
bd mol bond <proto> <parent> # Attach to existing mol
|
||||||
bd mol squash <id> # Condense to digest
|
bd mol squash <id> # Condense to digest (explicit ID)
|
||||||
bd mol burn <id> # Discard wisp
|
bd mol burn <id> # Discard wisp (explicit ID)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Agent Operations (gt)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Hook management (operates on current agent's hook)
|
||||||
|
gt mol status # What's on MY hook
|
||||||
|
gt mol current # What should I work on next
|
||||||
|
gt mol progress <id> # Execution progress of molecule
|
||||||
|
gt mol attach <bead> <mol> # Pin molecule to bead
|
||||||
|
gt mol detach <bead> # Unpin molecule from bead
|
||||||
|
gt mol attach-from-mail <id> # Attach from mail message
|
||||||
|
|
||||||
|
# Agent lifecycle (operates on agent's attached molecule)
|
||||||
|
gt mol burn # Burn attached molecule (no ID needed)
|
||||||
|
gt mol squash # Squash attached molecule (no ID needed)
|
||||||
|
gt mol step done <step> # Complete a molecule step
|
||||||
|
```
|
||||||
|
|
||||||
|
**Key distinction**: `bd mol burn/squash <id>` take explicit molecule IDs.
|
||||||
|
`gt mol burn/squash` operate on the current agent's attached molecule
|
||||||
|
(auto-detected from working directory).
|
||||||
|
|
||||||
## Agent Lifecycle
|
## Agent Lifecycle
|
||||||
|
|
||||||
### Polecat Shutdown
|
### Polecat Shutdown
|
||||||
|
|||||||
Reference in New Issue
Block a user