Skip to main content

​
Agent Tools

Each intern has 18 shell tools at /home/agent/tools/ that handle integrations with external services. All tools are identity-aware — they read the agent’s name, label, and signature from /home/agent/state/identity.json.

​
Linear

ToolUsageDescription
linear-checklinear-checkQueries Linear for issues tagged with this intern’s label. Returns JSON with issue details.
linear-startlinear-start <issue_id>Moves a Linear issue to In Progress.
linear-commentlinear-comment <issue_id> "body"Adds a comment to a Linear issue. Auto-signs with the intern’s signature.

​
GitHub

ToolUsageDescription
gh-my-prsgh-my-prsLists this intern’s active open PRs from Supabase.
gh-pr-commentsgh-pr-comments <repo> <pr_num>Gets new human comments on a PR (filters out bots, handles inline + review + top-level). Normalizes timestamps.
gh-pr-comments-ackgh-pr-comments-ack <repo> <pr_num>Marks PR comments as seen in Supabase (prevents re-processing).

​
Slack

ToolUsageDescription
slack-sendslack-send <channel_id> "text"Sends a message to Slack. Auto-prefixes with [intern-<name>].

​
Supabase State

ToolUsageDescription
whoamiwhoamiReturns the agent’s full profile from Supabase (name, status, capacity, etc.).
work-can-takework-can-takeChecks if the intern can accept new work (compares active tasks vs max capacity). Returns yes or no.
work-startwork-start <linear_id> <identifier> <title> <desc>Registers a new task in Supabase, sets agent status to busy.
work-add-prwork-add-pr <repo> <pr_num> <url> <branch> <identifier> <title>Tracks a new PR in Supabase, linked to the active task.
work-check-mergedwork-check-mergedChecks GitHub for merged/closed PRs, updates Supabase. Frees agent capacity when all PRs for a task are merged.
log-activitylog-activity <action> '<json_details>'Writes to the activity log in Supabase.
heartbeatheartbeatUpdates last_heartbeat timestamp in Supabase.

​
Git

ToolUsageDescription
git-reset-allgit-reset-allHard resets all repos to their default branch (main or master, auto-detected). Also reapplies Angular budget and environment fixes.

​
Build

ToolUsageDescription
rebuild-if-changedrebuild-if-changed [l5ui|layerfivecore|both]Rebuilds the live preview. Applies Angular fixes, runs Docker build, restarts nginx/Django. Auto-elevates to agent user if called as root.

​
Claude Auth

ToolUsageDescription
claude-authclaude-auth checkChecks if Claude CLI is authenticated. Alerts Slack with SSH instructions if not.

​
How Tools Work

All tools read secrets from environment files: 
/home/agent/.env-agent-name    → intern name
/home/agent/.env-supabase-url  → Supabase REST URL
/home/agent/.env-supabase-key  → service_role key
/home/agent/.env-linear-key    → Linear API key
/home/agent/.env-slack-token   → Slack bot token
/home/agent/.env-github        → GitHub PAT
/home/agent/.env-cf-token      → Cloudflare API token
/home/agent/.env-cf-account    → Cloudflare account ID
Identity is read from: 
/home/agent/state/identity.json

{
  "name": "intern-golf",
  "label": "intern:golf",
  "signature": "— intern-golf",
  "git_user": "intern-golf",
  "git_email": "intern-golf@lunarsolargroup.com",
  "slack_channel": "C0AP5ELSCJK",
  "repos": ["layerfivecore", "l5ui", "docs"],
  "org": "Lunar-Mission-Control",
  "max_active_tickets": 1
}