- namespace
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-config -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-config -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-config -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-config -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/jmagly/aiwg/tree/HEAD/agentic/code/addons/agent-loop/skills/ralph-configFrom the publisher
Skill access pattern (post-kernel-pivot, 2026.5+)
Skill names referenced in this document are AIWG skills, not slash commands. Most are not kernel-listed and cannot be invoked as
/skill-nameby the platform. Reach them via:aiwg discover "<capability>" aiwg show skill <name> --bodyOnly kernel-listed skills (
aiwg-doctor,aiwg-refresh,aiwg-status,aiwg-help,use,steward) are directly invokable as slash commands. See skill-discovery rule.
View and modify Al's runtime configuration. Settings control loop behavior defaults such as iteration limits, timeouts, provider selection, and commit behavior. Changes persist to .aiwg/ralph/config.json and apply to all subsequent loops unless overridden per-invocation.
Before any confirmation below, read and apply
agent-loop authorization checkpoints.
Call aiwg config authorization check --action-file "$ACTION_FILE" --target "$TARGET_REPO"
for host-classified effects. Only auto-authorized with a signed receipt skips
that workflow prompt; retain existing prompts/refusals otherwise. Platform
prompts are never bypassed. Limits, regression and threat overrides still require review.
Users may say:
One of show, set, reset, or preset.
set)The configuration key to change. See the configuration reference below.
set)The new value to assign to the key.
preset)One of the built-in preset names: ci, thorough, or quick.
show Subcommand.aiwg/ralph/config.json; if absent, show built-in defaultsOutput (active config):
Al Configuration
Source: .aiwg/ralph/config.json
Key Value Default Modified
─────────────── ─────────── ───────── ────────
maxIterations 5 10 yes
timeout 30 60 yes
provider claude claude no
model (default) (default) no
autoCommit true true no
branch null null no
quiet true false yes
memory true true no
crossTask false false no
analytics false false no
Active preset: ci (applied 2026-04-01)
To change a value: /ralph-config set <key> <value>
To reset defaults: /ralph-config reset
Output (no config file — using defaults):
Al Configuration
Source: built-in defaults (no .aiwg/ralph/config.json found)
Key Value
─────────────── ─────────
maxIterations 10
timeout 60
provider claude
model (default)
autoCommit true
branch null
quiet false
memory true
crossTask false
analytics false
To customize: /ralph-config set <key> <value>
To apply a preset: /ralph-config preset <ci|thorough|quick>
set Subcommand.aiwg/ralph/config.jsonOutput:
Al config updated.
maxIterations: 10 → 15
Saved to: .aiwg/ralph/config.json
Validation error — unknown key:
Unknown configuration key: 'maxIter'
Did you mean 'maxIterations'?
Run /ralph-config show to see all valid keys.
Validation error — wrong type:
Invalid value for 'maxIterations': 'lots'
Expected: integer >= 1
Got: 'lots'
Example: /ralph-config set maxIterations 15
reset Subcommand.aiwg/ralph/config.json with built-in defaultsConfirmation prompt:
This will reset all Al configuration to defaults.
Current non-default values:
maxIterations: 5 (default: 10)
timeout: 30 (default: 60)
quiet: true (default: false)
Type 'yes' to confirm reset:
After reset:
Al configuration reset to defaults.
.aiwg/ralph/config.json has been cleared.
All future loops will use built-in default values.
preset Subcommandci, thorough, or quickPreview before applying:
Applying preset: ci
Changes:
maxIterations: 10 → 5
timeout: 60 → 30
quiet: false → true
Other keys are unchanged.
Apply? (yes/no):
After applying:
Preset 'ci' applied.
Al will now use:
maxIterations: 5
timeout: 30 minutes
quiet: true
These values persist until changed or reset.
Saved to: .aiwg/ralph/config.json
Unknown preset:
Unknown preset: 'aggressive'
Available presets:
ci — max 5 iterations, 30m timeout, quiet (for pipelines)
thorough — max 20 iterations, 120m timeout (for complex tasks)
quick — max 3 iterations, 15m timeout (for exploration)
Usage: /ralph-config preset <name>
Each context has its own config file. show, set, reset, and preset operate on the in-session config by default. Use /ralph-config --external show to inspect external loop config (if the --external flag is available in your install).
Config file unreadable:
Cannot read Al config: .aiwg/ralph/config.json
Permission error or corrupted JSON. Options:
1. Delete the file to reset to defaults: rm .aiwg/ralph/config.json
2. Inspect manually: cat .aiwg/ralph/config.json
Read-only directory:
Cannot write to .aiwg/ralph/config.json.
Check that the .aiwg/ralph/ directory is writable:
chmod 755 .aiwg/ralph/
/ralph-config show
Response: Table of all current values with defaults and modified markers.
/ralph-config set maxIterations 15
Response: Confirms maxIterations: 10 → 15, writes file.
/ralph-config preset ci
Response: Previews 3 changes, prompts confirmation, applies and saves.
/ralph-config preset thorough
Response: Sets max 20 iterations and 120-minute timeout.
/ralph-config set autoCommit false
Response: Loop iterations will no longer create git commits.
/ralph-config reset
Response: Confirms which values will revert, then clears the config file.
ralph — Start an in-session loop (uses this config as defaults)ralph-external — Start a crash-resilient external loopralph-status — Check active loop stateralph-memory — Manage accumulated loop memoryView and configure agent loop settings — show, set, reset, and apply named presets
---name: ralph-configdescription: View and configure agent loop settings — show, set, reset, and apply named presets---# agentic/code/addons/agent-loop/skills/ralph-config/SKILL.mdFAQ
Download agentic/code/addons/agent-loop/skills/ralph-config/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/jmagly/aiwg.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.