settings

Configure agent memory backend, search mode, temporal decay, and citation settings in agent-config.json.

62|14|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/crisandrews/ClawCode --skill settings-crisandrews
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: settings
Source: https://github.com/crisandrews/ClawCode/tree/main/skills/settings
Command: npx skills add https://github.com/crisandrews/ClawCode --skill settings-crisandrews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an agent's configuration file by hand is error-prone, especially when the config controls security-sensitive settings and direct writes are blocked. This Skill provides a safe, guided workflow to view and modify agent settings like the memory backend, search mode, temporal decay, citations, heartbeat schedule, and HTTP bridge. ## Core Features & Use Cases - Memory backend configuration: Switch between the builtin SQLite + FTS5 + BM25 backend and the QMD backend with local embeddings, vector search, and reranking. - Safe config writes: All changes go through a Bash heredoc with JSON validation and atomic mv, so a malformed write can never clobber the existing config. - Heartbeat, dreaming, and HTTP bridge settings: Configure active hours, nightly memory consolidation schedules, and an optional local WebChat server with token authentication. - Use Case: You want semantic memory search instead of keyword matching. Invoke the skill, and it checks whether qmd is installed, guides installation if needed, merges the QMD block into agent-config.json while preserving all other keys, and tells you to run /mcp to reload. ## Quick Start Ask the agent to show the current settings or to switch the memory backend to QMD with vsearch mode.

Frequently Asked Questions about settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch the agent memory backend to QMD?

Invoke the settings skill and request the QMD backend. It checks whether the qmd binary is installed, guides installation via bun if missing, merges the QMD config block into agent-config.json preserving other keys, and prompts you to run /mcp to reload.

What is the difference between builtin and QMD memory backends?

The builtin backend uses SQLite with FTS5 full-text search, BM25 ranking, temporal decay, and MMR re-ranking with no external tools. QMD adds local embeddings via node-llama-cpp, vector search, and reranking, but requires installing the qmd binary.

Why can't I edit agent-config.json with the Write tool?

agent-config.json is on the always-on protected-paths list, so direct Write is refused by exec-gate. Changes must go through a Bash heredoc with JSON validation and atomic mv, giving the user one explicit permission prompt per change.

Which QMD search mode should I use?

The default vsearch mode is recommended, offering vector search with reranking at medium speed and excellent quality. Use search for faster basic hybrid results, or query for full query expansion when quality matters most.

How do I enable the WebChat browser interface?

Set http.enabled to true in agent-config.json, then run /mcp to reload and open http://localhost:18790 in a browser. Bind to 127.0.0.1 and set a token if exposing the port through a tunnel.

Can I change channel scope settings through agent settings?

No, scope.* keys are on the security-sensitive blocklist and read-only via agent_config. Use /agent:scope wizard or /agent:scope enable instead, which routes changes through Bash for explicit user consent.