config-reader
Read and manage daplug configuration from CLAUDE.md using <daplug_config> blocks, with legacy fallback and migration support.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Daplug Config Reader
Centralized configuration reader/migrator for daplug settings stored in <daplug_config> blocks inside CLAUDE.md. Provides backwards compatibility with legacy plaintext settings and safe migrations.
When to Use This Skill
- Any command/skill needs daplug settings (preferred agent, worktree dir, llms_txt dir, ai usage awareness, cli logs dir)
- Before writing to CLAUDE.md for daplug settings
- When a user asks to migrate or audit CLAUDE.md config
Config Format
<daplug_config>
preferred_agent: codex
worktree_dir: .worktrees/
llms_txt_dir: /storage/projects/docker/llms_txt
ai_usage_awareness: enabled
cli_logs_dir: ~/.claude/cli-logs/
</daplug_config>
Usage
PLUGIN_ROOT=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)
CONFIG_READER="$PLUGIN_ROOT/skills/config-reader/scripts/config.py"
Get Single Setting
python3 "$CONFIG_READER" get preferred_agent
Dump All Settings (JSON)
python3 "$CONFIG_READER" dump --json
Dump as ENV Vars
python3 "$CONFIG_READER" dump --env
Status / Verification
python3 "$CONFIG_READER" status
python3 "$CONFIG_READER" status --json
Check Legacy Settings
python3 "$CONFIG_READER" check-legacy
Migrate Legacy Settings
# Project and user
python3 "$CONFIG_READER" migrate --all
# Project only
python3 "$CONFIG_READER" migrate --project
# User only
python3 "$CONFIG_READER" migrate --user
Set a Setting
# Project scope
python3 "$CONFIG_READER" set worktree_dir ".worktrees/" --scope project
# User scope
python3 "$CONFIG_READER" set preferred_agent "codex" --scope user
Notes
- Lookup order: project CLAUDE.md (repo root) → user ~/.claude/CLAUDE.md
- Legacy plaintext settings are still supported but trigger warnings
- Migrations create a timestamped backup before writing
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!