iris-core

Create a new sub-agent — no Terraform, no Docker by default. Starts as a systemd service, patched into the bridge immediately so @agent works right away.

Commit and push repo changes to GitHub using the standard Iris workflow.

Search the web using Perplexity AI API. Returns sourced, up-to-date information.

Send an email via Resend API from ${IRIS_EMAIL_FROM:-iris@example.com}. Use when human escalation is needed or to deliver results outside Slack/Telegram.

Transcribe an audio file (m4a, mp3, wav, ogg, webm) to text using OpenAI Whisper API. Use when a user shares a voice note or audio attachment.

Add, remove, and test MCP (Model Context Protocol) servers by editing meta/mcp.json. Tools from connected servers appear automatically as mcp__<server>__<tool>.

Expose a local port as a public HTTPS subdomain under IRIS_BASE_DOMAIN. Writes nginx config, obtains SSL cert via certbot, reloads nginx.

Retrieve a secret through the platform abstraction instead of calling Key Vault directly.

Store a secret, or mint a one-time drop link so a user can share a secret without pasting it into chat. Use whenever a user is about to share a credential.

Opt-in Azure profile only — common Azure CLI patterns for auth, infrastructure, and operational checks.

Opt-in Firecracker profile only — provision, verify, reset, and destroy Firecracker microVM sub-agents.

Create, list, and cancel reminders and recurring tasks via Iris's events queue. Use when asked to "remind me", "every morning", "at 5pm", or any scheduled/recurring request.

Define the protocol Iris follows when creating new reusable skills.

Sub-agent self-diagnostic and escalation. Run when a sub-agent detects a failure it cannot recover from, to escalate to Iris or the human operator.

Read-only health snapshot of this Iris install — service state, disk, sub-agent containers, recent errors, and message-processing check. Use when asked "are you healthy", "what's your status", or when diagnosing problems.

Opt-in Azure/Terraform profile only — plan and apply Terraform changes using the safe Iris workflow.

Persist files through the storage abstraction rather than writing to arbitrary paths.