Ben Sigman
166 lines
4.1 KiB
Markdown
166 lines
4.1 KiB
Markdown
# CLI Commands
|
||
|
||
All commands accept `--palace <path>` to override the default palace location.
|
||
|
||
## `mempalace init`
|
||
|
||
Detect rooms from your folder structure and set up the palace.
|
||
|
||
```bash
|
||
mempalace init <dir>
|
||
mempalace init <dir> --yes # non-interactive mode
|
||
```
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `<dir>` | Project directory to scan |
|
||
| `--yes` | Auto-accept all detected entities |
|
||
|
||
What it does:
|
||
1. Scans for people and projects in file content
|
||
2. Detects rooms from folder structure
|
||
3. Creates `~/.mempalace/` config directory
|
||
4. Saves detected entities to `<dir>/entities.json`
|
||
|
||
## `mempalace mine`
|
||
|
||
Mine files into the palace.
|
||
|
||
```bash
|
||
mempalace mine <dir>
|
||
mempalace mine <dir> --mode convos
|
||
mempalace mine <dir> --mode convos --extract general
|
||
mempalace mine <dir> --wing myapp
|
||
```
|
||
|
||
| Option | Default | Description |
|
||
|--------|---------|-------------|
|
||
| `<dir>` | — | Directory to mine |
|
||
| `--mode` | `projects` | `projects` for code/docs, `convos` for chat exports |
|
||
| `--wing` | directory name | Wing name override |
|
||
| `--agent` | `mempalace` | Agent name tag |
|
||
| `--limit` | `0` (all) | Max files to process |
|
||
| `--dry-run` | — | Preview without filing |
|
||
| `--extract` | `exchange` | `exchange` or `general` (for convos mode) |
|
||
| `--no-gitignore` | — | Don't respect .gitignore |
|
||
| `--include-ignored` | — | Always scan these paths even if ignored |
|
||
|
||
## `mempalace search`
|
||
|
||
Find anything by semantic search.
|
||
|
||
```bash
|
||
mempalace search "query"
|
||
mempalace search "query" --wing myapp
|
||
mempalace search "query" --wing myapp --room auth
|
||
mempalace search "query" --results 10
|
||
```
|
||
|
||
| Option | Default | Description |
|
||
|--------|---------|-------------|
|
||
| `"query"` | — | What to search for |
|
||
| `--wing` | all | Filter by wing |
|
||
| `--room` | all | Filter by room |
|
||
| `--results` | `5` | Number of results |
|
||
|
||
## `mempalace split`
|
||
|
||
Split concatenated transcript mega-files into per-session files.
|
||
|
||
```bash
|
||
mempalace split <dir>
|
||
mempalace split <dir> --dry-run
|
||
mempalace split <dir> --min-sessions 3
|
||
mempalace split <dir> --output-dir ~/split-output/
|
||
```
|
||
|
||
| Option | Default | Description |
|
||
|--------|---------|-------------|
|
||
| `<dir>` | — | Directory with transcript files |
|
||
| `--output-dir` | same dir | Write split files here |
|
||
| `--dry-run` | — | Preview without writing |
|
||
| `--min-sessions` | `2` | Only split files with N+ sessions |
|
||
|
||
## `mempalace wake-up`
|
||
|
||
Show L0 + L1 wake-up context (~170–900 tokens).
|
||
|
||
```bash
|
||
mempalace wake-up
|
||
mempalace wake-up --wing driftwood
|
||
```
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--wing` | Project-specific wake-up |
|
||
|
||
## `mempalace compress`
|
||
|
||
Compress drawers using AAAK Dialect.
|
||
|
||
```bash
|
||
mempalace compress --wing myapp
|
||
mempalace compress --wing myapp --dry-run
|
||
mempalace compress --config entities.json
|
||
```
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| `--wing` | Wing to compress (default: all) |
|
||
| `--dry-run` | Preview without storing |
|
||
| `--config` | Entity config JSON file |
|
||
|
||
## `mempalace status`
|
||
|
||
Show what's been filed — drawer count, wing/room breakdown.
|
||
|
||
```bash
|
||
mempalace status
|
||
```
|
||
|
||
## `mempalace repair`
|
||
|
||
Rebuild palace vector index from stored data. Fixes segfaults after database corruption.
|
||
|
||
```bash
|
||
mempalace repair
|
||
```
|
||
|
||
Creates a backup at `<palace_path>.backup` before rebuilding.
|
||
|
||
## `mempalace mcp`
|
||
|
||
Helper command that outputs setup syntax (like `claude mcp add...`) to connect MemPalace to your AI client, automatically handling paths.
|
||
|
||
```bash
|
||
mempalace mcp
|
||
mempalace mcp --palace ~/.custom-palace
|
||
```
|
||
|
||
## `mempalace hook`
|
||
|
||
Run hook logic for Claude Code / Codex integration.
|
||
|
||
```bash
|
||
mempalace hook run --hook stop --harness claude-code
|
||
mempalace hook run --hook precompact --harness claude-code
|
||
mempalace hook run --hook session-start --harness codex
|
||
```
|
||
|
||
| Option | Values | Description |
|
||
|--------|--------|-------------|
|
||
| `--hook` | `session-start`, `stop`, `precompact` | Hook name |
|
||
| `--harness` | `claude-code`, `codex` | Harness type |
|
||
|
||
## `mempalace instructions`
|
||
|
||
Output skill instructions to stdout.
|
||
|
||
```bash
|
||
mempalace instructions init
|
||
mempalace instructions search
|
||
mempalace instructions mine
|
||
mempalace instructions help
|
||
mempalace instructions status
|
||
```
|