Agents

In aix, an Agent represents a full configuration set: a system prompt (persona), a set of tools, and specific configuration settings. This is primarily used for platforms like OpenCode and Claude Code that support switching between different “profiles”.

Listing Agents#

To see which agents are currently available on your system:

aix agent list

Output:

NAME            PLATFORM    DESCRIPTION
default         opencode    General purpose coding assistant
senior-dev      claude      Strict code reviewer with security focus
python-expert   opencode    Specialized for Python/Django development

Inspecting an Agent#

To view the details of a specific agent, including its system prompt and active tools:

aix agent show senior-dev

Discovering Agents#

Agents can also be discovered and installed from repositories. When you add a repository, aix indexes any agent definitions found in the agents/ subdirectory.

aix agent list --all  # Shows both installed and available from repos

Creating Agents#

Support for creating new agents directly via aix is currently in preview.

Currently, aix detects agents defined in your platform-specific configuration directories (e.g., ~/.config/opencode/agents/). Future versions will allow you to define agents in a platform-agnostic format similar to Skills.

Best Practices#

• Specialization: Create separate agents for distinct roles (e.g., “Tech Lead” vs “QA Tester”) rather than one giant agent.
• Skill Reuse: Use Skills to share capabilities between agents, rather than hardcoding tools into the agent definition.