Agent Profile Creator

Create agent profiles stored as config.json in ~/.aider-desk/agents/{name}/ (global) or {project}/.aider-desk/agents/{name}/ (project-level).

READ REFERENCES before proposing to ensure accuracy: - Tool groups & schema: references/agent-profile-schema.md - Tool approvals: references/tool-approval-guide.md + references/agent-profile-schema.md - Subagent config: references/subagent-guide.md - Examples: references/profile-examples.md

Simplified Q&A Process

Step 1: Understand Purpose

Ask user: "Describe the agent's purpose and what it should do."

Based on their response, internally propose all properties: - Name (derived from purpose) - Max iterations (default 250) - Tool groups (based on purpose) - Custom instructions (if applicable) - Subagent config (always enabled, contextMemory: "off" by default) - Tool approvals (based on needs)

READ all reference files before proposing.

Step 2: Provider/Model

Ask: "Which provider/model? (format: provider/model, e.g., anthropic/claude-sonnet-4-5-20250929)"

• Split by first slash to get provider and model
• No validation - use as-is (correct obvious typos only)

Step 3: Optional Advanced Settings

ONLY ask if user specifically mentioned temperature, max tokens, rate limiting, or MCP servers:

• "What temperature should I use?" (0.1-1.0, optional)
• "Max tokens limit?" (optional)
• "Min time between tool calls in ms?" (optional)
• "Which MCP servers should be enabled?" (optional, default: none)

If not mentioned, skip this entire step.

Step 4: Location

Ask: "Global profile (all projects) or project-specific? (default: global)"

Step 5: Single Review & Confirm

Present one complete summary with all proposed properties. Ask:

"Here's your agent profile. Should I create it?"

Show: - Name, provider/model - Tool groups enabled - Tool approvals summary (which are "never", which are "always") - Subagent config - Location

DO NOT ask for confirmations on individual items. Only one final approval.

Step 6: Create

On user confirmation, generate the profile.

READ references/profile-examples.md to verify structure before creating files.

Tool Group Reference

• Power Tools: File system, shell, search (for agents that read/write files)
• Aider Tools: AI code generation via Aider (NOT default - see note below)
• Power Search: Advanced code search (for analysis/docs)
• Todo Tools: Task list management (for agents that track work)
• Memory Tools: Persistent information storage (for learning agents)
• Skills Tools: Access to project-specific skills (for agents using custom skills)
• Subagents: Task delegation to specialized subagents (for agents that can call others)

Aider Tools Note: Specialized for AI code generation. Do NOT enable by default. - If user wants coding: explain Aider (advanced refactoring) vs Power Tools (direct editing) - Ask preference before enabling

Tool Approval Strategy

Keys: {group}---{tool} (three dashes)

Default is "ask". Only set: - "never": Tools completely irrelevant (e.g., power---bash for read-only agents) - "always": Safe, essential tools (e.g., read operations for reviewers)

READ references/tool-approval-guide.md to see all available tools and their purposes.

Only include tools that exist in reference docs.

Subagent Configuration

Every agent is a subagent (enabled: true)

READ references/subagent-guide.md for detailed guidance on context memory modes and configuration:

• contextMemory: Default is "off" (fresh each time)
• Use "full-context" only for specialized analysis agents (code review, security audit)
• Use "last-message" for progressive builders (documentation, iterative tasks)
• systemPrompt: Specialized for agent's purpose
• invocationMode: automatic (specialized), on-demand (general)
• color: Relevant color (e.g., red=security, blue=power tools)
• description: Clear description for auto-invocation

File Structure

{profile-name}/
└── config.json

Validation

• Unique name
• Provider/model: Use as-is (correct obvious typos only)
• Tool keys: {group}---{tool} format
• Values: "always", "ask", or "never"
• Subagent enabled
• All tool keys from references

Resources

• references/agent-profile-schema.md - Complete schema
• references/subagent-guide.md - Subagent configuration guide (context memory modes)
• references/profile-examples.md - Examples
• references/tool-approval-guide.md - Tool approval config
• assets/templates/config.json.template - Template
• assets/examples/sample-profile.json - Example