faf-clawdbot

Universal AI context for ClawdBot.

ClawdBot (58k+ stars) is a powerful self-hosted AI assistant. It uses SOUL.md for personality—but that file is trapped in one workspace. faf-clawdbot sets it free.

Your soul becomes persistent and eternal—never re-explain yourself to AI again.

The Problem

Your ClawdBot personality lives in ~/clawd/SOUL.md. But what about:

• Your Claude Desktop setup?
• Your Cursor workspace?
• Your VS Code projects?
• Your team's shared configuration?

You end up maintaining multiple files that drift apart.

The Solution

One project.faf file. Renders everywhere.

project.faf (single source of truth)
       │
       ├──→ SOUL.md     (ClawdBot)
       ├──→ CLAUDE.md   (Claude Code)
       ├──→ .cursorrules (Cursor)
       └──→ Any MCP-compatible tool

Edit once. Context everywhere. Eternal.

Install

npm install -g faf-clawdbot

Quick Start

# Navigate to your ClawdBot workspace
cd ~/clawd

# Create a universal context file
faf-clawdbot init "my-assistant"

# Edit your context (one file, all platforms)
nano project.faf

# Generate SOUL.md for ClawdBot
faf-clawdbot sync

Commands

| Command | Description | |---------|-------------| | init [name] | Create project.faf in current directory | | sync | Generate SOUL.md from project.faf | | watch | Auto-sync on file changes | | status | Show sync status |

Example Configuration

project:
  name: "my-assistant"
  goal: "Personal AI that works across all my tools"

persona:
  tone: "Direct, helpful, no fluff"
  style: "Senior engineer"
  traits:
    - "Concise responses"
    - "Proactive suggestions"
    - "Code examples when relevant"

context:
  owner: "James"
  preferences:
    - "No emojis unless asked"
    - "Explain reasoning briefly"

stack:
  model: "claude-opus-4-5"
  platforms:
    - "telegram"
    - "slack"

Why Universal?

| SOUL.md | project.faf | |---------|-------------| | ClawdBot only | Works everywhere | | Freeform markdown | Structured YAML | | One workspace | Portable across tools | | Custom format | IANA-registered standard | | Manual sync | Automated rendering |

One Soul, Many Renderings

                ┌─────────────────┐
                │   project.faf   │  ← Your single source of truth
                │   (your soul)   │  ← IANA: application/vnd.faf+yaml
                └────────┬────────┘
                         │
                   RENDER ENGINE
                         │
       ┌─────────────────┼─────────────────┐
       ▼                 ▼                 ▼
  ┌─────────┐      ┌──────────┐      ┌──────────┐
  │ SOUL.md │      │CLAUDE.md │      │GEMINI.md │
  │ClawdBot │      │  Claude  │      │  Gemini  │
  │ 58k ★   │      │Anthropic │      │  Google  │
  └─────────┘      └──────────┘      └──────────┘

Same soul. Same personality. Every tool. Persistent. Eternal. Zero drift.

How It Fits

Your project directory:
├── package.json     ← npm's context
├── project.faf      ← AI's context (universal)
├── README.md        ← Human's context
└── SOUL.md          ← Generated for ClawdBot

The .faf file sits naturally alongside package.json—one for npm, one for AI.

Related Tools

| Tool | Command | Output | |------|---------|--------| | faf-clawdbot | faf-clawdbot sync | SOUL.md | | faf-cli | faf bi-sync | CLAUDE.md | | faf-cursor | faf-cursor sync | .cursorrules |

All read the same project.faf. All stay in sync.

Links

• FAF Specification — The universal format
• IANA Registration — application/vnd.faf+yaml
• faf-cli — Core CLI tool
• ClawdBot — The AI assistant

License

MIT

Built by Wolfe-Jam | Powered by FAF