agenix

Appearance

Profiles ​

A profile is a single YAML file that fully describes an agent: executor + model + authentication + knowledge + MCP servers + env.

yaml
name: my-agent
agent: claude-code            # see agenix agents
model:
  id: anthropic/claude-sonnet-5   # litellm notation: provider/model
  baseUrl: http://localhost:4000  # optional: gateway / local server
auth:
  mode: subscription          # inherit | subscription | api-key | env
knowledge: ./knowledge        # path relative to the profile
mcpServers:
  - name: filesystem
    transport: stdio          # stdio | http | sse
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
env: {}                       # additional environment variables
extraArgs: []                 # additional executor CLI flags

Model ​

model.id uses litellm notation (anthropic/claude-sonnet-5, ollama_chat/qwen2.5-coder:14b, openai/gpt-5-codex) — the profile is portable across executors. The adapter translates the id into the executor's native format.

model.baseUrl points the executor at a gateway (LiteLLM proxy) or a local OpenAI-compatible server (Ollama, vLLM, llama.cpp, LM Studio) — this way any executor works with any model.

Validation ​

Profiles are validated by zod schemas at load time: a typo in a field or an incompatible combination (e.g. subscription on an executor without subscription support) produces a clear error immediately, not a crash in the middle of a run.