---
name: aim:set
description: Configure an agent's settings in the current AIM session. Use when the user runs /aim:set.
argument-hint: @<agent-name> <setting> <value>
---

# AIM Set

Configure settings for an agent in the current session.

## Available Settings

### Agent settings (require `@agent-name`)
- `permission_mode`: Controls what the agent can do without asking
  - `default` - Standard permissions (prompts for most actions)
  - `acceptEdits` - Auto-approve file edits (like Shift+Tab)
  - `plan` - Read-only mode
  - `bypassPermissions` - Skip all permission checks (use with caution)
- `timeout_ms`: Maximum time to wait for agent response (in milliseconds, minimum 1000)

### Session settings (no agent name needed)
- `break_timeout_ms`: How long the sidecar polls for replies before giving up (minimum 10000, default 120000)

## Instructions

1. Parse from `$ARGUMENTS`: agent name (strip the @ prefix, if present), setting name, value
2. Call the `aim_set` MCP tool. For session-level settings like `break_timeout_ms`, omit the `agent` parameter.
3. Confirm the setting was updated