What is troubleshooting?

Perfect for Agentic AI Agents needing advanced troubleshooting capabilities for daemon management and session state corruption. A content-addressed homoiconic skill tree for agentic AI

How do I install troubleshooting?

Run the command: npx killer-skills add osoleve/the-fold/troubleshooting. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for troubleshooting?

Key use cases include: Debugging daemon won't start issues, Resolving session state corruption, Identifying test hangs due to fuel consumption.

Which IDEs are compatible with troubleshooting?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for troubleshooting?

Requires filesystem access for .fold-repl directory. Bash command-line interface needed. Limited to troubleshooting daemon and session state issues.

troubleshooting

Install troubleshooting, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md

Readonly

Troubleshooting The Fold

Name: troubleshooting
Availability: InStock
Author: osoleve

Quick Fixes

Check daemon status

bash
1./fold --status

Daemon won't start

bash
1./daemon.sh stop     # Clear stale state
2./daemon.sh cleanup  # Kill orphan workers
3./daemon.sh start    # Or just run ./fold - it auto-starts

Session state corruption

bash
1rm -rf .fold-repl/   # Nuclear option - clears all session state
2./fold "(help)"      # Auto-starts fresh daemon

Tests hanging

Check fuel consumption. Infinite loops exhaust fuel and return out-of-fuel error.

scheme
1;; In REPL, check fuel status
2(fuel)

File Locations

REPL Infrastructure

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)

Persistent State

Path	Purpose
`.fold-sessions/`	Persistent session state (survives daemon restart)
`.fold-users/`	User profile data

Content-Addressed Store

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)

BBS Runtime

Path	Purpose
`.bbs/`	BBS runtime data
`.bbs/counter`	Next issue ID
`.bbs/deps/`	Dependency tracking
`.bbs/index/`	Search index cache

Project Files

Path	Purpose
`TAXONOMY.sexp`	Machine-readable project taxonomy
`CLAUDE.md`	Agent instructions (this file)
`docs/agent-operating-manual.md`	Agent procedures

Common Issues

"Daemon not responding"

Check if daemon is running: ./fold --status
Check daemon log: cat .fold-repl/daemon.log
Kill and restart: ./daemon.sh stop && ./fold --status

"Session not found"

Sessions are ephemeral unless named with -s:

bash
1./fold -s mywork "(define x 10)"  # Creates named session
2./fold -s mywork "x"              # Uses same session

"Module not found" during require

Check you're in project root (where core/, lattice/, boundary/ live)
Verify module exists: ls lattice/<module>/
Check for typos in module name

"Out of fuel" error

The expression exceeded its fuel budget. Options:

Simplify the expression
Check for infinite recursion
Increase fuel budget (if safe)

"Hash mismatch" or CAS errors

The CAS store may be corrupted. Options:

Check .store/ permissions
Run integrity check: ./fold "(cas-verify)"
Rebuild from git: rm -rf .store && ./fold "(cas-rebuild)"

BBS shows stale data

After reloading modules, refresh BBS state:

scheme
1(bbs-init!)  ; Refresh from disk

troubleshooting — community troubleshooting, the-fold, community, ide skills, Claude Code, Cursor, Windsurf

About this Skill

Agent Capability Analysis

Ideal Agent Persona

Core Value

↓ Capabilities Granted for troubleshooting

! Prerequisites & Limits

Browser Sandbox Environment

⚡️ Ready to unleash?