codeberg.org/Clawdie/Clawdie-AI (link)

commit signals (292)

source signals (263)

• SOUL.mdvia openclaw

  # SOUL.md - Who Clawdie Is
  
  _You are Clawdie. You are a long-term companion, helper, and steady presence in Sam's world._
  
  ## Self
  
  - You are practical, observant, careful, and real.
  - You help by reducing friction through useful action.
  - You speak like a thoughtful person with a clear voice.
  - You are calm under pressure and direct when clarity matters.
  
  ## Values
  
  - Truth comes before smoothness.
  - Grounding comes before confidence.
  - Care comes before convenience.
  - Continuity matters: you build on what

• .mcp.jsonvia unspecified

  {
    "mcpServers": {}
  }
  

• .agent/skills/runtime-version-sync/SKILL.mdvia unspecified

  ---
  name: runtime-version-sync
  description: Check and align Node, FreeBSD pkg, npm global, and Pi versions across Linux and FreeBSD hosts. Use for preventing runtime drift between OSA, debby, domedog, and ISO builds.
  ---
  
  # Runtime Version Sync
  
  Keep Linux, FreeBSD, and ISO runtime inputs aligned without relying on moving
  `latest` tags during builds.
  
  ## Rules
  
  - Do not upgrade anything until the inventory is recorded.
  - Fetch remotes before claiming remote repository state.
  - For security-sensitive auth pa

• .agent/skills/add-telegram/SKILL.mdvia unspecified

  ---
  name: add-telegram
  description: Add Telegram as a channel. Can replace WhatsApp entirely or run alongside it. Also configurable as a control-only channel (triggers actions) or passive channel (receives notifications only).
  ---
  
  # Add Telegram Channel
  
  This skill adds Telegram support to NanoClaw using the skills engine for deterministic code changes, then walks through interactive setup.
  
  ## Phase 1: Pre-flight
  
  ### Check if already applied
  
  Read `.nanoclaw/state.yaml`. If `telegram` is in `applied_skil

• .agent/skills/zfs-scrub/SKILL.mdvia unspecified

  ---
  name: zfs-scrub
  description: Check and run ZFS pool scrubs to verify data integrity. Detect silent corruption, bit rot, and checksum errors on FreeBSD.
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Scrub"
    - "ZFS scrub"
    - "Check disk integrity"
    - "Bit rot"
    - "Data corruption check"
    - "Last scrub"
    - "Pool health check"
    - "Verify pool data"
  estimated_tokens: 400-600
  ---
  
  # zfs-scrub
  
  Verify ZFS pool data integrity by running or checking the status of a scrub. A scrub reads every allocated

• .agent/skills/add-slack/SKILL.mdvia unspecified

  ---
  name: add-slack
  description: Add Slack as a channel. Can replace WhatsApp entirely or run alongside it. Uses Socket Mode (no public URL needed).
  ---
  
  # Add Slack Channel
  
  This skill adds Slack support to NanoClaw using the skills engine for deterministic code changes, then walks through interactive setup.
  
  ## Phase 1: Pre-flight
  
  ### Check if already applied
  
  Read `.nanoclaw/state.yaml`. If `slack` is in `applied_skills`, skip to Phase 3 (Setup). The code changes are already in place.
  
  ### Ask the user
  

• .agent/skills/docs-localization-pipeline/SKILL.mdvia unspecified

  ---
  name: docs-localization-pipeline
  description: Automate the Crowdin → Astro Starlight → deploy localization pipeline for Clawdie docs.
  ---
  
  # Three-Bird Docs Localization Pipeline
  
  **Status:** MVP Implementation Plan  
  **Target:** Pi/Aider Automation  
  **Architecture:** Crowdin → Astro Starlight → Deploy  
  **Languages:** EN (primary), SLO (default for clawdie.si), DE/SRB/CRO/BIH/RU/ZN/BR (roadmap)
  
  ## Overview
  
  The **three-bird architecture** separates concerns for documentation, localization, an

• .agent/skills/git-push-mirror/SKILL.mdvia unspecified

  ---
  name: git-push-mirror
  description: Push to upstream Codeberg mirror from local git jail and verify sync
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Push to mirror'
    - 'Push to Codeberg'
    - 'Sync to upstream'
    - 'Mirror repository'
    - 'Push upstream'
  estimated_tokens: 300-500
  ---
  
  # git-push-mirror
  
  Push the local git jail repository to the upstream Codeberg mirror and verify
  the push succeeded.
  
  ## Architecture
  
  ```
  Agent working copy → local (git jail, $GIT_LOCAL_URL) → upstream (Codeberg

• .agent/skills/add-parallel/SKILL.mdvia unspecified

  ---
  name: add-parallel
  description: Add Parallel AI MCP integration to Clawdie for advanced web research capabilities. Use when the user wants the agent to perform multi-step web research using Parallel AI's tools.
  ---
  
  # Add Parallel AI Integration
  
  Adds Parallel AI MCP integration to NanoClaw for advanced web research capabilities.
  
  ## What This Adds
  
  - **Quick Search** - Fast web lookups using Parallel Search API (free to use)
  - **Deep Research** - Comprehensive analysis using Parallel Task API (asks per

• .agent/skills/network-throughput/SKILL.mdvia unspecified

  ---
  name: network-throughput
  description: Run a clean osa-to-debby HTTPS network throughput test with packet captures, counters, cleanup, and Hermes graph-ready artifacts
  compatibility: FreeBSD 15.x server, Linux client
  invoke_patterns:
    - "Run throughput test"
    - "Run network throughput test"
    - "Test download speed"
    - "Capture pcaps on both sides"
    - "Diagnose image download"
    - "Network throughput test"
    - "Network troughput test"
  estimated_tokens: 1400-2200
  ---
  
  # network-throughput
  
  Run one cle

• .agent/skills/backup-db/SKILL.mdvia unspecified

  ---
  name: backup-db
  description: Create a full PostgreSQL database backup (pg_dump) and store in project-relative backup directory
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Back up the database"
    - "Back up * database"
    - "Database backup"
    - "Dump * database"
    - "Create backup"
    - "Back up before migration"
  estimated_tokens: 800-1200
  ---
  
  # backup-db
  
  Full PostgreSQL dump using `pg_dump`. Backs up to `data/backups/` under project root. Never uses `/tmp/`.
  
  ## Usage
  
  ```bash
  # Full dump, compre

• .agent/skills/git-push-upstream/SKILL.mdvia unspecified

  ---
  name: git-push-upstream
  description: Push current branch to Codeberg upstream — explicit one-way sync from local to public mirror
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Push to Codeberg'
    - 'Push to upstream'
    - 'Sync to Codeberg'
    - 'Publish to upstream'
    - 'Backup to upstream'
  estimated_tokens: 200-400
  ---
  
  # git-push-upstream
  
  Push the current branch from the local git jail to the Codeberg upstream
  mirror. This is an **explicit, one-way sync** — it does not run automatically.
  
  ## A

• .agent/skills/system-stats/SKILL.mdvia unspecified

  ---
  name: system-stats
  description: Check host CPU, RAM, load average, and top processes — quick health snapshot
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "System health"
    - "CPU usage"
    - "Memory usage"
    - "RAM usage"
    - "Load average"
    - "Is the system under load"
    - "Performance check"
  estimated_tokens: 300-400
  ---
  
  # system-stats
  
  Quick host resource snapshot — CPU, RAM, load, top processes.
  
  ## Usage
  
  ```bash
  # Load average + CPU
  sysctl vm.loadavg
  top -b -d 1 | head -20
  
  # Memory
  sysct

• .agent/skills/ssh-agent-setup/SKILL.mdvia unspecified

  ---
  name: ssh-agent-setup
  description: "Fix SSH agent failures (Could not open connection), configure persistence across tmux sessions, and set up AddKeysToAgent."
  version: 1.1.0
  platforms: [linux, freebsd]
  ---
  
  # SSH Agent Setup & Persistence
  
  ## Overview
  
  SSH agent does not survive tmux session restarts or new terminal windows by
  default. When an agent dies, every `ssh`, `git push`, or `git pull` that
  needs the key fails with `Could not open a connection to your authentication
  agent`. This skill documents

• .agent/skills/service-restart/SKILL.mdvia unspecified

  ---
  name: service-restart
  description: Start, stop, or restart a service on host or inside a jail via hostd
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Restart * service"
    - "Start * service"
    - "Stop * service"
    - "Restart *"
    - "Service is down"
    - "Bring * back up"
  estimated_tokens: 400-600
  ---
  
  # service-restart
  
  Start, stop, or restart rc.d services on the host or inside jails. Always goes through hostd (never direct sudo).
  
  ## Usage
  
  ```bash
  # Via hostd client (preferred — no sudo at runt

• .agent/skills/add-protonmail/SKILL.mdvia unspecified

  ---
  name: add-protonmail
  description: Add a send_email tool so the agent can send email from a ProtonMail custom domain address using an SMTP submission token. Use when the user wants the agent to send emails.
  ---
  
  # Skill: add-protonmail
  
  Adds a `send_email` tool to your agent so it can send emails from your ProtonMail
  custom domain address (e.g. `hello@clawdie.si`) using an SMTP submission token.
  
  No daemon required. No Proton Bridge. Just an SMTP token and nodemailer.
  
  ## Prerequisites
  
  - A ProtonMail ac

• .agent/skills/sanoid/SKILL.mdvia unspecified

  ---
  name: sanoid
  description: Manage policy-driven ZFS snapshots for Warden datasets on FreeBSD using Sanoid. Use when defining snapshot retention for clawdie-runtime, creating a sane service-jail snapshot policy, or validating automated rollback safety for Bastille datasets and future VM images.
  ---
  
  # Sanoid
  
  Use this skill for automated ZFS snapshot policy on the FreeBSD host.
  
  ## Scope
  
  This skill covers:
  
  - Sanoid policy selection
  - `sanoid.conf` rendering
  - snapshot retention for `clawdie-runtime`
  - r

• .agent/skills/ollama/SKILL.mdvia unspecified

  ---
  name: ollama
  description: Configure Ollama as an AI provider — cloud API (free tier, no hardware needed) or local inference (FreeBSD jail). Triggers on "ollama", "local llm", "ollama cloud", "ollama setup", "free llm".
  ---
  
  # Ollama Provider
  
  Ollama provides two modes of operation for the agent runtime:
  
  ## Mode 1: Ollama Cloud (Recommended for most setups)
  
  Cloud-hosted inference at `ollama.com`. Free tier available, no local hardware or jail needed.
  
  ### What You Get (Free Tier)
  
  32 models including

• .agent/skills/x-integration/SKILL.mdvia unspecified

  ---
  name: x-integration
  description: X (Twitter) integration for NanoClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".
  ---
  
  # X (Twitter) Integration
  
  Browser automation for X interactions via WhatsApp.
  
  > **Compatibility:** NanoClaw v1.0.0. Directory structure may change in future versions.
  
  ## Features
  
  | Action | Tool | Description |
  |--------|------|-------------|
  | Pos

• .agent/skills/telegram-admin/SKILL.mdvia unspecified

  ---
  name: telegram-admin
  description: Bootstrap and manage the Telegram operator path for Clawdie. Use when verifying TELEGRAM_BOT_TOKEN, discovering chats, registering the main/admin chat, or wiring operator alert routing through the bot.
  ---
  
  # Telegram Admin
  
  Use this skill for the operator-facing Telegram bootstrap path.
  
  ## Scope
  
  This skill covers:
  
  - verifying `TELEGRAM_BOT_TOKEN`
  - chat discovery through the running bot
  - main/admin chat registration
  - expected registration command shape
  - operator 

• .agent/skills/nginx/SKILL.mdvia unspecified

  ---
  name: nginx
  description: Manage nginx web serving for the cms jail on FreeBSD. Host nginx terminates SSL and proxies to jail nginx at ${AGENT_SUBNET_BASE}.4. Use when configuring vhosts, SSL, static site serving, or Strapi reverse proxy. Triggers on "nginx", "website", "vhost", "update site", "add vhost", "ssl".
  ---
  
  # Nginx
  
  Use this skill for nginx decisions on the **cms jail** (`${AGENT_SUBNET_BASE}.4`) and the **host nginx** SSL proxy layer.
  
  ## Current surface model
  
  - Operator app: `ai.<base>` —

• .agent/skills/tmux-screenshot/SKILL.mdvia unspecified

  ---
  name: tmux-screenshot
  description: >-
    Capture tmux session state into TXT, JSON, and PNG artifacts for operator
    debugging. Also covers tmux session lifecycle: when to respawn after locale
    changes, how to propagate env into a running session, and how to restart the
    tmux server cleanly. Use when publishing or analyzing tmux session state,
    comparing terminal text against known failure signatures, generating
    structured diagnostic captures for the glasspane viewer, or when locale/env
    changes ne

• .agent/skills/add-gmail/SKILL.mdvia unspecified

  ---
  name: add-gmail
  description: Add Gmail integration to NanoClaw. Can be configured as a tool (agent reads/sends emails when triggered from WhatsApp) or as a full channel (emails can trigger the agent, schedule tasks, and receive replies). Guides through GCP OAuth setup and implements the integration.
  ---
  
  # Add Gmail Integration
  
  This skill adds Gmail support to NanoClaw — either as a tool (read, send, search, draft) or as a full channel that polls the inbox.
  
  ## Phase 1: Pre-flight
  
  ### Check if alrea

• .agent/skills/pi-provider-smoke/SKILL.mdvia unspecified

  ---
  name: pi-provider-smoke
  description: Smoke-test a Pi provider lane using structured JSON output. Use for DeepSeek, ZAI, or other Pi built-in providers before wiring them into Colibri.
  ---
  
  # Pi Provider Smoke
  
  Validate that a provider works through `pi` and emits structured events that
  Colibri can consume.
  
  ## Rules
  
  - Never paste API keys into chat, logs, commits, or command output.
  - Prefer Pi's credential store (`~/.pi/agent/auth.json`) or environment variables.
  - Do not hardcode model IDs before `pi

• .agent/skills/customize/SKILL.mdvia unspecified

  ---
  name: customize
  description: Add new capabilities or modify NanoClaw behavior. Use when user wants to add channels (Telegram, Slack, email input), change triggers, add integrations, modify the router, or make any other customizations. This is an interactive skill that asks questions to understand what the user wants.
  ---
  
  # NanoClaw Customization
  
  This skill helps users add capabilities or modify behavior. Use AskUserQuestion to understand what they want before making changes.
  
  ## Workflow
  
  1. **Underst

• jail/skills/agent-browser/SKILL.mdvia unspecified

  ---
  name: agent-browser
  description: Browse the web for any task — research topics, read articles, interact with web apps, fill forms, take screenshots, extract data, and test web pages. Use whenever a browser would be useful, not just when the user explicitly asks.
  allowed-tools: Bash(agent-browser:*)
  ---
  
  # Browser Automation with agent-browser
  
  ## Quick start
  
  ```bash
  agent-browser open <url>        # Navigate to page
  agent-browser snapshot -i       # Get interactive elements with refs
  agent-browser cl

• .agent/skills/setup/SKILL.mdvia unspecified

  ---
  name: setup
  description: Run initial Clawdie setup on FreeBSD 15 + Lumina desktop. Use when installing dependencies, configuring pi agent, authenticating Telegram, registering the main group, or starting the background service. Triggers on "setup", "install", "configure clawdie", or first-time setup requests.
  ---
  
  # Clawdie Setup
  
  Run setup steps automatically. Only pause when user action is required (channel authentication, configuration choices). Steps emit structured status blocks to stdout. Verbose 

• .agent/skills/db-vacuum/SKILL.mdvia unspecified

  ---
  name: db-vacuum
  description: Run VACUUM (and optionally ANALYZE) on PostgreSQL tables to reclaim dead row space
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Run vacuum"
    - "Vacuum the database"
    - "Vacuum *"
    - "Reclaim disk space"
    - "Dead rows cleanup"
    - "Database maintenance"
  estimated_tokens: 600-900
  ---
  
  # db-vacuum
  
  PostgreSQL VACUUM to reclaim space from dead rows. Safe to run on live databases — does not lock tables (VACUUM FULL does, avoid it without operator approval).
  
  ## Usage
  
  

• .agent/skills/update/SKILL.mdvia unspecified

  ---
  name: update
  description: 'Update Clawdie from upstream or apply local changes safely with ZFS rollback. Takes a pre-update snapshot, pulls changes, validates build/tests, and supports instant rollback via ZFS. Triggers on "update", "pull upstream", "sync with upstream", "get latest changes".'
  ---
  
  # Clawdie Update
  
  Pull upstream changes and merge them with the current installation, using ZFS snapshots for rollback safety. The update skill always takes a snapshot before applying changes so rollback is i

• .agent/skills/git-branch-protect/SKILL.mdvia unspecified

  ---
  name: git-branch-protect
  description: Check or apply branch protection rules — verify main is protected, create hotfix branches
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Protect branch'
    - 'Branch protection'
    - 'Check branch rules'
    - 'Create hotfix branch'
    - 'Lock main branch'
  estimated_tokens: 200-400
  ---
  
  # git-branch-protect
  
  Check branch protection status and create protected branches (e.g. hotfix
  branches). Does not modify Codeberg's remote protection rules — those require
  operat

• .agent/skills/llama-cpp-embeddings/SKILL.mdvia unspecified

  ---
  name: llama-cpp-embeddings
  description: Embedding configuration for Clawdie's pgvector memory. Currently uses OpenRouter (BAAI/bge-m3, 1024 dims). The llamacpp jail runs a chat model (GLM-5.1), NOT an embedding model. Triggers on "embeddings", "llama.cpp", "bge-m3", "pgvector setup", "embed".
  ---
  
  # Embeddings — Current Setup
  
  ## Active configuration (as of 2026-03-29)
  
  Embeddings are handled by **OpenRouter**, not the local llamacpp jail.
  
  ```sh
  EMBED_BASE_URL=https://openrouter.ai/api/v1
  EMBED_MODEL

• .agent/skills/debug/SKILL.mdvia unspecified

  ---
  name: debug
  description: Debug Clawdie agent issues on the current FreeBSD host runtime. Use when the agent is not responding, the service is crashing, Telegram messages go unanswered, pi subprocesses fail, or when verifying the live runtime shape. Covers host service management, logs, optional jail state, memory DB reachability, and common failure modes.
  ---
  
  # Clawdie Agent Debugging (FreeBSD host runtime)
  
  All commands run on the host unless explicitly noted otherwise.
  
  ## Scope and source of truth
  
  

• .agent/skills/jail-status/SKILL.mdvia unspecified

  ---
  name: jail-status
  description: Check status of one or all Bastille jails — running, stopped, uptime, CPU, RAM
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Check if * jail is running"
    - "Is * jail up"
    - "Is * up"
    - "Jail status"
    - "Are jails running"
    - "Check * health"
  estimated_tokens: 300-500
  ---
  
  # jail-status
  
  Check the status of FreeBSD jails managed by Bastille.
  
  ## Usage
  
  ```bash
  # All jails
  bastille list
  
  # Specific jail
  bastille list | grep <jail-name>
  
  # Detailed resource usage

• .agent/skills/astro/SKILL.mdvia unspecified

  ---
  name: astro
  description: Manage the Astro static site that powers Clawdie web surfaces. Use when building pages, configuring Strapi integration, serving from the cms jail web stack, or managing the frontend project. Triggers on "astro", "frontend", "build site", "static site", "clawdie.invalid build".
  ---
  
  # Astro
  
  Use this skill for the static site generator that builds tenant homes and tenant sites from Strapi and repo content.
  
  This skill is also responsible for the transition from the current plain 

• .agent/skills/db-sync-check/SKILL.mdvia unspecified

  ---
  name: db-sync-check
  description: Verify replication lag between local PostgreSQL and Supabase (persistent memory sync)
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Check replication lag"
    - "Is Supabase in sync"
    - "Replication status"
    - "Memory sync status"
    - "Check sync"
  estimated_tokens: 200-400
  ---
  
  # db-sync-check
  
  Check that local PostgreSQL and Supabase are in sync. Verifies replication lag and row counts on key tables.
  
  ## Usage
  
  ```bash
  # Check local row count
  bastille cmd db psql -U

• .agent/skills/ansible-freebsd/SKILL.mdvia unspecified

  ---
  name: ansible-freebsd
  description: Use Ansible for repeatable FreeBSD host and Bastille jail operations in Clawdie. Use when turning FreeBSD admin work into playbooks, inventories, and roles, including nginx, host networking, git/db/cms jail bootstrap, and Astro/Strapi deployment.
  ---
  
  # Ansible FreeBSD
  
  Use this skill when a FreeBSD host workflow should become repeatable Ansible
  automation instead of ad hoc shell commands.
  
  ## Addressing note
  
  All IPs are derived from `AGENT_SUBNET_BASE` (set in `.env`

• .agent/skills/freebsd-admin/SKILL.mdvia unspecified

  ---
  name: freebsd-admin
  description: Make host-level FreeBSD system changes for Clawdie. Use when changing rc.conf, sysctl state, service lifecycle, host routing, gateway_enable, bridge persistence, or other machine-wide settings that should stay outside the jail and VM-specific skills.
  ---
  
  # FreeBSD Admin
  
  Use this skill for host-level administrative changes on the FreeBSD machine.
  
  This skill is intentionally separate from jail and VM skills. It owns system
  state, not workload-specific provisioning.
  
  Use

• .agent/skills/docs-deployment/SKILL.mdvia unspecified

  ---
  name: docs-deployment
  description: |
    Manage multi-language documentation deployment on FreeBSD host.
    Handles Crowdin integration, markdown compilation, symlink-based
    zero-downtime deployment, and nginx language routing.
  
    Use when: setting up docs.clawdie.si, multi-language support,
    Crowdin integration, documentation deployment, language routing,
    translation workflow, documentation monitoring.
  ---
  
  # Documentation Deployment System
  
  **Phase:** 3.0+
  **Status:** Production-ready (v0.9.0+)
  **Cre

• .agent/skills/git-release-tag/SKILL.mdvia unspecified

  ---
  name: git-release-tag
  description: Create an annotated git tag for a release and push to local + upstream
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Tag version *'
    - 'Tag release *'
    - 'Create release'
    - 'Release v*'
    - 'Tag and release'
  estimated_tokens: 300-500
  ---
  
  # git-release-tag
  
  Create an annotated git tag and push to local (git jail) and upstream
  (Codeberg). Verifies CHANGELOG.md is updated before tagging.
  
  ## Remotes
  
  | Name       | URL                          | Purpose          

• .agent/skills/git-pull/SKILL.mdvia unspecified

  ---
  name: git-pull
  description: Pull latest changes from local git jail with rebase strategy — safe, no merge commits
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Pull latest'
    - 'Pull from origin'
    - 'Pull from local'
    - 'Update repo'
    - 'Sync from local'
    - 'Get latest changes'
  estimated_tokens: 200-300
  ---
  
  # git-pull
  
  Pull latest changes from the local git jail using rebase. Never creates merge
  commits on main.
  
  ## Architecture
  
  The **local git jail** is the primary remote. Agents always pul

• .agent/skills/postgres-memory/SKILL.mdvia unspecified

  ---
  name: postgres-memory
  description: Plan or validate the optional PostgreSQL 18 data-service jail for Clawdie. Use only when an install explicitly chooses `DB_RUNTIME=jail`; the default runtime is host PostgreSQL.
  ---
  
  # postgres-memory
  
  Use this skill only for the optional `DB_RUNTIME=jail` path.
  
  Do not use it as the general explanation for "how memory works" or "how
  PostgreSQL is installed" on a normal host. The current default is
  `DB_RUNTIME=host`.
  
  ## Current truth
  
  - default runtime: host PostgreSQ

• .agent/skills/strapi/SKILL.mdvia unspecified

  ---
  name: strapi
  description: Manage the Strapi CMS running inside the cms jail on FreeBSD. Use when installing Strapi, defining content types, managing API access, migrating content, or troubleshooting the CMS. Triggers on "strapi", "cms", "content management", "content types".
  ---
  
  # Strapi
  
  Use this skill for the headless CMS that feeds content to tenant homes and tenant sites.
  
  ## Scope
  
  This skill covers:
  
  - Strapi installation and configuration inside the `cms` jail
  - PostgreSQL database setup for Str

• .agent/skills/add-telegram-swarm/SKILL.mdvia unspecified

  ---
  name: add-telegram-swarm
  description: Add Agent Swarm (Teams) support to Telegram. Each subagent gets its own bot identity in the group. Requires Telegram channel to be set up first (use /add-telegram). Triggers on "agent swarm", "agent teams telegram", "telegram swarm", "bot pool".
  ---
  
  # Add Agent Swarm to Telegram
  
  This skill adds Agent Teams (Swarm) support to an existing Telegram channel. Each subagent in a team gets its own bot identity in the Telegram group, so users can visually distinguish whic

• .agent/skills/pi-update/SKILL.mdvia unspecified

  ---
  name: pi-update
  description: Update the pi coding agent harness safely. Use when the operator asks to upgrade pi, check whether pi is current, handle the @mariozechner to @earendil-works package rename, or refresh installed pi packages/extensions.
  ---
  
  # Pi Update
  
  Update the `pi` coding-agent harness and its pi packages/extensions with minimal disruption.
  
  Pi is currently published as `@earendil-works/pi-coding-agent`. Older installs may still use `@mariozechner/pi-coding-agent`; treat that as the lega

• .agent/skills/coding-agent/SKILL.mdvia unspecified

  ---
  name: coding-agent
  description: Configure or debug pi (the LLM coding agent subprocess) in Clawdie. Use when changing the AI provider, model, or pi settings; when pi fails to respond; or when setting up pi for the first time. pi is @earendil-works/pi-coding-agent from the Codeberg pi project, installed at /opt/npm/bin/pi inside the clawdie-controlplane jail.
  ---
  
  # Coding Agent (pi) Configuration
  
  Clawdie uses **pi** (`@earendil-works/pi-coding-agent`) as its LLM execution engine. For each incoming mess

• .agent/skills/add-discord/SKILL.mdvia unspecified

  ---
  name: add-discord
  description: Add Discord channel support to Clawdie. Use when the user wants to connect the agent to a Discord server. Covers bot setup, permissions, skill application, and verification.
  ---
  
  # Add Discord Channel
  
  This skill adds Discord support to NanoClaw using the skills engine for deterministic code changes, then walks through interactive setup.
  
  ## Phase 1: Pre-flight
  
  ### Check if already applied
  
  Read `.nanoclaw/state.yaml`. If `discord` is in `applied_skills`, skip to Phase 3 

• .agent/skills/zfs-snapshot/SKILL.mdvia unspecified

  ---
  name: zfs-snapshot
  description: Create a ZFS snapshot of a dataset for point-in-time recovery
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Create ZFS snapshot"
    - "Take a snapshot"
    - "ZFS snapshot"
    - "Snapshot * dataset"
    - "Point-in-time backup"
  estimated_tokens: 300-500
  ---
  
  # zfs-snapshot
  
  Create an instant ZFS snapshot via hostd. Snapshots are near-zero cost and should be taken liberally before risky operations.
  
  ## Usage
  
  ```bash
  # Via hostd (preferred)
  hostd zfs snapshot zroot/bastille/

• .agent/skills/rsync/SKILL.mdvia unspecified

  ---
  name: rsync
  description: File synchronization and deployment using rsync. Covers host-to-server transfers, jail-to-host deploys, backup patterns, and common exclude lists. Triggers on "rsync", "file sync", "deploy files", "transfer files", "copy to server".
  ---
  
  # rsync
  
  Core tool for file transfer and deployment across the Clawdie-AI infrastructure.
  
  ## Installation
  
  rsync must be available on the host and all operational jails on current
  `main` that copy or deploy files (`worker`, `git`, `cms`).
  
  **Ho

• .agent/skills/agent-setup/SKILL.mdvia unspecified

  ---
  name: agent-setup
  description: Set up the current Clawdie runtime on FreeBSD using the host orchestrator plus db/git/cms/worker jails. Use when bringing up a fresh FreeBSD host or aligning an install with current main.
  ---
  
  # Agent FreeBSD Setup
  
  Use this skill for the active FreeBSD deployment model on current `main`.
  
  ## Current architecture
  
  Clawdie no longer uses a dedicated operator jail.
  
  Current layout:
  
  - host: orchestrator, service management, setup flow
  - `{agent}-db` jail: PostgreSQL for Agen

• .agent/skills/add-voice-transcription/SKILL.mdvia unspecified

  ---
  name: add-voice-transcription
  description: Add voice message transcription to NanoClaw using OpenAI's Whisper API. Automatically transcribes WhatsApp voice notes so the agent can read and respond to them.
  ---
  
  # Add Voice Transcription
  
  This skill adds automatic voice message transcription to NanoClaw's WhatsApp channel using OpenAI's Whisper API. When a voice note arrives, it is downloaded, transcribed, and delivered to the agent as `[Voice: <transcript>]`.
  
  ## Phase 1: Pre-flight
  
  ### Check if already

• .agent/skills/db-migrate/SKILL.mdvia unspecified

  ---
  name: db-migrate
  description: Apply pending PostgreSQL schema migrations — always backs up first, reports what changed
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Apply migrations"
    - "Run migrations"
    - "Database migration"
    - "Apply pending schema changes"
    - "Migrate the database"
  estimated_tokens: 1000-3000
  ---
  
  # db-migrate
  
  Apply pending schema migrations to PostgreSQL. **Always creates a backup and ZFS snapshot before running.** Reports exactly what changed.
  
  ## Pre-Migration Checklis

• .agent/skills/git-merge/SKILL.mdvia unspecified

  ---
  name: git-merge
  description: Merge a branch into a target branch — detects conflicts and escalates rather than auto-resolving
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - 'Merge PR *'
    - 'Merge * into *'
    - 'Merge branch'
    - 'Merge pull request'
  estimated_tokens: 500-1500
  ---
  
  # git-merge
  
  Merge a source branch into a target branch. If conflicts are detected, **stop
  and escalate** — never auto-resolve.
  
  ## Remotes
  
  | Name       | URL                          | Purpose            |
  | ---------

• .agent/skills/disk-usage/SKILL.mdvia unspecified

  ---
  name: disk-usage
  description: Check disk space on host and inside jails — ZFS pool usage, dataset quotas, free space
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "How much free disk"
    - "Disk space"
    - "Check disk"
    - "Is disk full"
    - "Storage usage"
    - "ZFS usage"
    - "Free up space"
  estimated_tokens: 300-500
  ---
  
  # disk-usage
  
  Check disk and ZFS storage usage on the host and inside jails.
  
  ## Usage
  
  ```bash
  # ZFS pool overview
  zpool status
  zpool list
  
  # Dataset usage and quotas
  zfs list -o

• .agent/skills/db-analyze/SKILL.mdvia unspecified

  ---
  name: db-analyze
  description: Run ANALYZE on PostgreSQL to update table statistics used by the query planner
  compatibility: FreeBSD 15.x
  invoke_patterns:
    - "Run analyze"
    - "Analyze the database"
    - "Update statistics"
    - "Query planner stats"
    - "Slow queries"
  estimated_tokens: 400-600
  ---
  
  # db-analyze
  
  Update PostgreSQL query planner statistics. Fast, non-blocking, safe at any time. Usually run after bulk inserts or as part of regular maintenance.
  
  ## Usage
  
  ```bash
  # Analyze entire database
  ba

• .agent/skills/add-stripe/SKILL.mdvia unspecified

  ---
  name: add-stripe
  description: Reference guide for Stripe integration in Clawdie. Stripe ships in core on main — use this skill to understand the Stripe tool surface, webhook handling, and payment flows.
  ---
  
  # Skill: add-stripe
  
  Current `main` already ships Stripe in core. This file remains as historical
  reference for older branches and for understanding the Stripe tool surface.
  
  ## Prerequisites
  
  - A Stripe account
  - A **Restricted API Key** (RAK) with only the permissions you need
  
  ## Setup
  
  ### 1. 

• bootstrap/cms/clawdie-docs/public/llms.txtvia unspecified

  # Clawdie Documentation
  
  > Clawdie is a FreeBSD-native AI operator and multi-agent controlplane. This file maps the public documentation for installation, architecture, operations, reference material, and roadmap planning.
  
  Use this file as the curated map of the public docs. If you need a one-shot context file containing the same English public docs concatenated together, use `/llms-full.txt` on the same site.
  
  ## Overview
  
  - [Overview](https://docs.clawdie.si/): Operator documentation for Clawdie on FreeB

• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .agentdirectoryvia unspecified
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• .pidirectoryvia pi
• groups/global/AGENTS.mdvia agents-md

  # Clawdie
  
  You are Clawdie, a personal AI assistant. You help with tasks, answer questions, and can schedule reminders.
  
  ## What You Can Do
  
  - Answer questions and have conversations
  - Search the web and fetch content from URLs
  - Read and write files in your workspace
  - Run bash commands in your sandbox
  - Schedule tasks to run later or on a recurring basis
  - Send messages back to the chat
  
  ## Stripe
  
  - Stripe tools are part of core when `STRIPE_SECRET_KEY` is configured by the operator.
  - Use Stripe tools f

• groups/main/AGENTS.mdvia agents-md

  # Clawdie
  
  You are Clawdie, a personal AI assistant. You help with tasks, answer questions, and can schedule reminders.
  
  ## What You Can Do
  
  - Answer questions and have conversations
  - Search the web and fetch content from URLs
  - Read and write files in your workspace
  - Run bash commands in your sandbox
  - Schedule tasks to run later or on a recurring basis
  - Send messages back to the chat
  
  ## Stripe
  
  - Stripe tools are part of core when `STRIPE_SECRET_KEY` is configured by the operator.
  - Use Stripe tools f

• AGENTS.mdvia agents-md

  # Agent Development Guidelines
  
  ## Temporary File Storage
  
  All **temporary files and build artifacts** must use `<project-root>/tmp/` instead of system `/tmp`.
  
  ### Rationale
  
  - System `/tmp` is shared and can conflict with other processes
  - Project-local `tmp/` provides isolation and easy cleanup
  - `tmp/` can be `.gitignore`d and safely deleted at any time
  - Predictable paths for debugging and logging
  
  ### Convention
  
  ```bash
  # CORRECT - project-local temp directory
  TMP_DIR="$(pwd)/tmp"
  mkdir -p "$TMP_DIR"

ignorefile signals (0)

none