Workspace

The workspace is your GHOST’s home directory. Default: ~/GHOST/.

Directory Structure

• BOOT.md GHOST behavioral instructions
• SOUL.md GHOST personality and values
• OPERATOR.md Your preferences and goals
• Directorynotes/ Knowledge notes (markdown with YAML frontmatter)

  • …
• Directoryreferences/ Source material organized by topic

  • …
• Directorydiary/ Daily entries (YYYY-MM-DD.md)

  • …
• Directoryjobs/ Cron-scheduled job files

  • …
• Directoryskills/ Workflow definitions (agentskills.io format)

  • …
• Directoryagents/ Agent definitions (YAML frontmatter + prompt)

  • …
• Directoryservices/ Services definitions (docker compose file)

  • …
• Directory.web-cache/ Cached web fetches

  • …
• Directory.state/ Runtime state (database, logs)

  • …

What ghost init Creates

Running ghost init bootstraps the workspace with:

• Identity files: BOOT.md, SOUL.md, OPERATOR.md with starter templates
• Default skills: research, knowledge-navigator, note-writer, cron-job-author, skill-creator
• Default agents: heartbeat, chat-reflection, reflection, deep-research
• Configured local services: Crawl4AI, SearXNG, …
• All directories listed above