Configuration Reference¶
executor.sh Settings¶
| Variable | Default | Description |
|---|---|---|
POLL_INTERVAL |
60 |
Seconds between polling for new issues |
MODEL_DEFAULT |
sonnet |
Default Claude model |
MODEL_OPUS |
opus |
Model used when agent-opus label is set |
MAX_RETRIES |
3 |
Retries for transient API failures |
RETRY_DELAY |
10 |
Seconds between retries |
HEALTH_PORT |
8090 |
Health check HTTP port |
HEARTBEAT_INTERVAL |
1800 |
Discord heartbeat every 30 minutes |
repos.json¶
Defines which repositories the executor monitors:
{
"repos": [
{
"name": "star-rewards",
"url": "https://github.com/Stig-Johnny/star-rewards.git",
"description": "Reward-E - star rewards app for kids"
}
]
}
executor-settings.json¶
Defines tool permissions (allow/deny lists):
{
"permissions": {
"allow": [
"Read", "Write", "Edit", "Glob", "Grep",
"Bash(git *)", "Bash(xcodebuild *)",
"mcp__github__create_pull_request",
"mcp__discord__discord_send",
...
],
"deny": [
"mcp__github__merge_pull_request",
"mcp__appstoreconnect__submit_for_review",
...
]
}
}
See the full file in the repo for the complete allow/deny list.
.mcp.json¶
MCP server configuration. Available servers:
| Server | Purpose | Access |
|---|---|---|
| github | Issues, PRs, code search | Read + Write (PRs, comments) |
| revenuecat | Subscription metrics | Read only |
| appstoreconnect | Build status, versions | Read only |
| cutie-mcp | User feedback | Read only |
| context7 | Library documentation | Read only |
| claude-memory | Learnings, decisions | Read + Write |
| infra-health | Infrastructure status | Read only |
| discord | Notifications | Write |
| slack-notifications | Notifications | Write |
prompt.md¶
System prompt appended to every Claude Code session. Contains:
- Available MCP tools and usage guidance
- iOS build patterns (xcodebuild commands)
- Discord communication rules (progress updates, asking questions)
- Quality checklist (build, test, review diff)
- Escalation protocol for production actions
- Memory lifecycle (recall before, save after)
- Commit conventions
Key File Locations (Mac Mini)¶
| File | Path |
|---|---|
| Executor script | ~/repos/mac-executor/executor.sh |
| LaunchAgent plist | ~/Library/LaunchAgents/ai.invotek.mac-executor.plist |
| Executor log | ~/.claude/executor-logs/executor.log |
| LaunchAgent stdout | /tmp/mac-executor-launchd.log |
| LaunchAgent stderr | /tmp/mac-executor-launchd-err.log |
| Workspaces | /tmp/executor-workspaces/ |
| Stats | ~/.claude/executor-stats.jsonl |
| Claude history | ~/.claude/history.jsonl |
| GitHub config | ~/.config/gh/hosts.yml |