55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
# Command Reference
|
|
|
|
`user-thoughts` accepts `/user-thoughts` and `/ustht`. They are equivalent.
|
|
|
|
## Command Summary
|
|
|
|
| Command | Meaning |
|
|
|---|---|
|
|
| `/ustht init` | Initialize `.ustht/` in the current project. |
|
|
| `/ustht status` | Show skill state, instant state, raw count, and dimension count. |
|
|
| `/ustht skill` | Show `SKILL_STATUS`. |
|
|
| `/ustht skill on|off` | Enable or disable write operations. |
|
|
| `/ustht instant` | Show `INSTANT_STATUS`. |
|
|
| `/ustht instant on|off` | Enable or disable instant capture. |
|
|
| `/ustht sortin [--dry]` | Append raw entries into mdbase. |
|
|
| `/ustht resort [--dry]` | Reorganize all mdbase content semantically. |
|
|
| `/ustht raw` | Show unprocessed raw entries. |
|
|
| `/ustht mdbase show [--all|--dimension]` | Show the index, all dimensions, or one dimension. |
|
|
| `/ustht mdbase export [--all|--dimension]` | Export mdbase content. |
|
|
| `/ustht import <path>` | Import project-relevant decisions from markdown files. |
|
|
| `/ustht ignore start|end` | Start or stop a temporary ignore interval. |
|
|
| `/ustht ignore --last` | Remove the last raw entry and record it as ignored. |
|
|
| `/ustht ignore show` | Show ignored entries. |
|
|
|
|
## Natural-Language Mapping
|
|
|
|
Agents may map clear user intent to commands:
|
|
|
|
- "turn on project memory" -> `/ustht skill on && instant on`
|
|
- "stop recording this" -> `/ustht ignore start`
|
|
- "start recording again" -> `/ustht ignore end`
|
|
- "organize what I said" -> `/ustht sortin`
|
|
- "show what you remember" -> `/ustht mdbase show`
|
|
- "ignore the last note" -> `/ustht ignore --last`
|
|
|
|
When intent is ambiguous, ask a short clarification instead of guessing.
|
|
|
|
## Chained Commands
|
|
|
|
Commands can be chained with `&&` and should run left to right. Stop only if a command fails in a way that makes the following command unsafe.
|
|
|
|
Example:
|
|
|
|
```text
|
|
/ustht skill on && instant on && status
|
|
```
|
|
|
|
## Dimension Arguments
|
|
|
|
Dimension names must pass validation:
|
|
|
|
- lowercase letters, digits, and hyphens;
|
|
- `/` allowed for subdirectories, such as `ui/outline`;
|
|
- no spaces, `..`, backslashes, absolute paths, or reserved names.
|