Skip to content

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