Define AI agent roles in YAML and run them anywhere: CLI, API server, or autonomous daemon
Agent
This guide shows how to configure each built-in tool type using real examples from examples/roles/. For the full configuration reference (all fields, defaults, types), see tools.md. For writing custom tools and plugins, see toolcreation.md.
Agent
InitRunner's role registry lets you install, share, and discover roles from InitHub and OCI registries. Roles are downloaded, validated, and saved to /.initrunner/roles/ where they integrate automatically with the CLI.
Agent
InitRunner provides a single initrunner new command for creating role.yaml files. It supports multiple seed modes (templates, AI generation, examples, hub bundles, or local files) and an interactive refinement loop for iterating on the YAML before saving. Run with no arguments in a terminal and it shows a guided start…
Agent
Services are curated always-on agents: start once, they run on a schedule, report status, and stop without requiring YAML. Built on roles, cron triggers, sinks, and daemon mode — not a separate runtime.
Agent
Skills are self-contained bundles of tools and system prompt instructions packaged as Markdown files. They enable composition and reuse across agents — define a capability once, reference it from any role. Skills use the SKILL.md format (compatible with the agentskills.io standard) with InitRunner extensions for tool…
Agent
This guide covers the four ways to extend InitRunner with tools: built-in tools (contributing to InitRunner itself), custom tools (Python modules), declarative API tools (YAML-only), and the plugin registry (distributable packages).
Agent
Tools give agents the ability to interact with the outside world — reading files, making HTTP requests, connecting to MCP servers, calling APIs, or running custom Python functions. They are configured in the tools list of a role definition. A bare name (- search) enables a tool with defaults; a mapping adds options (…