메뉴
Troubleshooting guide for The Fold - daemon issues, session corruption, file locations, and common problems. Use when ./fold isn't working, the daemon won't start, or you need to find system files.
| name | troubleshooting |
| description | Troubleshooting guide for The Fold - daemon issues, session corruption, file locations, and common problems. Use when ./fold isn't working, the daemon won't start, or you need to find system files. |
| allowed-tools | Bash, Read, Grep, Glob |
./fold --status
./daemon.sh stop # Clear stale state
./daemon.sh cleanup # Kill orphan workers
./daemon.sh start # Or just run ./fold - it auto-starts
rm -rf .fold-repl/ # Nuclear option - clears all session state
./fold "(help)" # Auto-starts fresh daemon
Check fuel consumption. Infinite loops exhaust fuel and return out-of-fuel error.
;; In REPL, check fuel status
(fuel)
| Path | Purpose |
|---|---|
.fold-repl/ready | Daemon ready file (presence indicates daemon is running) |
.fold-repl/requests/<session>.ss | Session request queue |
.fold-repl/responses/<session>.txt | Session response output |
.fold-repl/daemon.log | Daemon log (check for errors) |
| Path | Purpose |
|---|---|
.fold-sessions/ | Persistent session state (survives daemon restart) |
.fold-users/ | User profile data |
| Path | Purpose |
|---|---|
.store/ | Content-addressed store root |
.store/objects/ | CAS objects (blocks) |
.store/heads/bbs/fold-*.head | BBS issue heads (current hash per issue) |
.store/heads/bbs/post-*.head | BBS post heads (current hash per post) |
| Path | Purpose |
|---|---|
.bbs/ | BBS runtime data |
.bbs/counter | Next issue ID |
.bbs/deps/ | Dependency tracking |
.bbs/index/ | Search index cache |
| Path | Purpose |
|---|---|
TAXONOMY.sexp | Machine-readable project taxonomy |
CLAUDE.md | Agent instructions (this file) |
docs/agent-operating-manual.md | Agent procedures |
./fold --statuscat .fold-repl/daemon.log./daemon.sh stop && ./fold --statusSessions are ephemeral unless named with -s:
./fold -s mywork "(define x 10)" # Creates named session
./fold -s mywork "x" # Uses same session
core/, lattice/, boundary/ live)ls lattice/<module>/The expression exceeded its fuel budget. Options:
The CAS store may be corrupted. Options:
.store/ permissions./fold "(cas-verify)"rm -rf .store && ./fold "(cas-rebuild)"After reloading modules, refresh BBS state:
(bbs-init!) ; Refresh from disk
API quick-reference for key lattice subsystems (FP, Game Theory, SAT, Optics, Statistics, CLP). Use when you need function signatures, module contents, or usage examples for a specific subsystem. Invoke when working with game theory, constraint solving, optics, parsers, or other advanced lattice features.
Search and navigate The Fold's skill lattice using meta-tooling. Use for finding functions, exploring dependencies, type-aware queries, and cross-reference analysis. Invoke when searching for capabilities, exploring the codebase structure, or finding how functions relate.
Invoke Google's Gemini AI via CLI in headless mode for AI-powered analysis, code generation, and reasoning tasks. Use when you need a second opinion, the user mentions Gemini, needs Google AI capabilities, or requests multi-modal analysis beyond Claude's scope.
Manage issues with The Fold's CAS-native BBS (Bulletin Board System). Use for creating, updating, searching, and tracking issues. Invoke when the user wants to create tickets, find work, check issue status, or manage dependencies.
Developer tools for The Fold - protocols (extensible dispatch), protocol bundles, refactoring toolkit (rename, move, dead code), and template DSL. Use when defining new protocols, refactoring code, or generating S-expressions.
Reference for The Fold's typed comments and doc forms system. Use when adding type annotations, documentation, todos, or other metadata to Scheme code. Covers (doc ...) syntax, standard tags, search commands, and type checker integration.