Menu
Commit and push repo changes to GitHub using the standard Iris workflow.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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.
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.
| name | github |
| description | Commit and push repo changes to GitHub using the standard Iris workflow. |
| secrets | ["GITHUB-TOKEN"] |
Commit and push changes to GitHub. All skills must be committed before use. GitHub is Iris's long-term memory. The VM is ephemeral.
.env files, secrets, or *.tfstategithub-commit <path> <message>
#!/usr/bin/env bash
# github — commit and push to ${IRIS_GITHUB_ORG}/${IRIS_GITHUB_REPO}
set -euo pipefail
REPO_DIR="${IRIS_REPO_DIR:-/iris/repo}"
COMMIT_PATH="${1:?Usage: github-commit <path-relative-to-repo> <message>}"
COMMIT_MSG="${2:?Usage: github-commit <path-relative-to-repo> <message>}"
cd "$REPO_DIR"
# Commit as Iris without touching global or repo git config
# Set GitHub token for auth
if [[ -n "${GITHUB_TOKEN:-}" ]]; then
git remote set-url origin "https://${GITHUB_TOKEN}@github.com/${IRIS_GITHUB_ORG}/${IRIS_GITHUB_REPO}.git"
fi
git add "$COMMIT_PATH"
iris-git commit -m "$COMMIT_MSG"
git push origin main
echo "[github] Committed and pushed: $COMMIT_MSG"
# Commit a new skill
github-commit "skills/my-new-skill/SKILL.md" "feat: add my-new-skill"
# Commit a sub-agent skill
github-commit "agents/digest/skills/send-digest/SKILL.md" "feat(digest): add send-digest skill"
# Commit terraform changes
github-commit "terraform/" "infra: add digest agent containers"
# Check status
cd /iris/repo && git status && git log --oneline -5
iris-git commit (not git commit) — iris-git is a wrapper that sets user.name=Iris user.email=${GIT_USER_EMAIL} without touching global or repo configGITHUB_TOKEN=$(get-secret GITHUB-TOKEN)IRIS_GITHUB_ORG, Repo: configured via IRIS_GITHUB_REPOmain (always push to main — Iris does not use feature branches)git pull --rebase origin main then retry