harlan-github-agent
/harlan-github-agent
Manage or diagnose Harlan's local GitHub maintenance service. Use for repository monitoring, automated issue or PR work, agent activity, conflicts, and its dashboard.
- Author
- harlan-zw ↗
- Repository
- harlan-claude-code ↗
- Licence
- MIT
- Last repository change
- 28.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Manage or diagnose Harlan's local GitHub maintenance service. Use for repository monitoring, automated issue or PR work, agent activity, conflicts, and its dashboard.
Original author description
Manage or diagnose Harlan's local GitHub maintenance service. Use for repository monitoring, automated issue or PR work, agent activity, conflicts, and its dashboard.
How it works
- Connect
- Read Service state
- Control the Service
- Authority and deeper contracts
SKILL.md preview
---
name: harlan-github-agent
description: "Manage or diagnose Harlan's local GitHub maintenance service. Use for repository monitoring, automated issue or PR work, agent activity, conflicts, and its dashboard."
license: MIT
---
# Harlan GitHub Agent
Use the installed CLI to inspect and control the durable Service.
Keep scheduling in the Service.
## Connect
Context sync installs the CLI for noninteractive shells on both hosts.
Run `pnpm sync:context` locally and `pnpm sync:context:hogwild` for Hogwild.
Service updates also install it.
Desktop:
```bash
harlan-github-agent control status
```
Hogwild from desktop:
```bash
hw run agent 'harlan-github-agent control status'
```
The launcher resolves the Service checkout and its pinned Node runtime.
It uses `~/.config/harlan-github-agent/config.yml` by default.
It reads `dashboard-password` beside that file.
Desktop reads `~/.config/harlan-github-agent/control-url`.
Context sync creates it with the Hogwild URL if missing.
It preserves an existing target.
Hogwild uses `http://127.0.0.1:3210`.
Explicit `--config`, `--url`, and `--password-file` arguments win.
A desktop `--config` override reads that file's Service URL unless `--url` is also set.
Use `HARLAN_GITHUB_AGENT_URL` to override the installed desktop target.
Never print credentials or place their values in saved commands.
If the launcher is missing, use this source command once:
```bash
ssh hogwild 'cd ~/.local/share/harlan-github-agent/service && ~/.local/lib/harlan-github-agent/node --experimental-strip-types packages/harlan-github-agent/src/cli.ts control status --config ~/.config/harlan-github-agent/config.yml --url http://127.0.0.1:3210'
```
Then restore the launcher through context sync.
Do not guess a built CLI path inside `dist/`.
Installed Plugin caches contain Skills, rather than the Service package.
The Service checkout lives at `~/.local/share/harlan-github-agent/service`.
Use `HARLAN_GITHUB_AGENT_CHECKOUT` for an explicit checkout override.
## Read Service state
```bash
harlan-github-agent control tasks
harlan-github-agent control incidents
harlan-github-agent control activity --task TASK_ID
harlan-github-agent control events --limit 50
harlan-github-agent control reviews --repository OWNER/REPOSITORY --number NUMBER
harlan-github-agent control reviews --repository OWNER/REPOSITORY --number NUMBER --head FULL_HEAD_SHA
```
Commands print one JSON value. Tagged errors exit with status 1.
`status` returns `{ health, state }`.
`tasks`, `incidents`, and `activity` use focused Service reads.
`activity` returns redacted live activity for a Running or Publishing Task.
Other known Task states return `TaskActivityUnavailable`, including the current state.
Only an unknown Task returns `TaskNotFound`.
Use `reviews` for stored Review findings after a Task completes.
`reviews` returns `{ runs }`, preserving findings and gates.
The head filter requires all 40 characters.
An empty `runs` array means no stored Review matches that query.
It does not mean Review passed.
Use `watch-pr` to wait through authenticated Service events.
```bash
harlan-github-agent control watch-pr --repository OWNER/REPOSITORY --number NUMBER --until review --timeout-seconds 600
```
Use `--until merged` to wait through actionable findings.
The default stops for attention after Service Tasks stop owning the head.
Changed states go to stderr. Terminal state goes to stdout.
Reconnect with the same command after a Service restart.
Follow [pull request watching](../pr/references/pull-request-watch.md) for submission completion.
## Control the Service
Use `pause`, `resume`, `restart`, `update`, or `cancel --task TASK_ID` for the matching durable control.
Use `routine-run --routine OWNER/REPOSITORY:NAME` to open a run ahead of its cron.
Use `stop-review --repository OWNER/REPOSITORY --number NUMBER --head HEAD_SHA` to stop that exact Review.
After configuration changes, use a durable Restart request.
It lets active Agents and controller writes finish before systemd starts the next process.
Never use Pause or raw unit restart to coordinate a routine restart.
For paired Service updates, run `pnpm service:hogwild:update`.
The helper holds one local lock through the desktop update.
Another update or restart on that host fails before it reaches the Service.
During drain, the helper reports active Tasks, occupied Agent slots, and elapsed seconds.
It names each active Task, its repository, issue or pull request, state, and available progress label.
It reports changed counts and a heartbeat every 30 seconds.
It also reports changed Task details when counts stay equal.
After desktop restart, it requires a fresh report with the current protocol.
If that check fails, inspect the desktop unit and Service connection.
Its durable Update blocks new Tasks before file sync.
The helper marks preparation Ready after sync, then waits for existing work.
Failed preparation releases its hold without changing manual Pause.
If the Service lacks preparation support, use its installed desktop helper first:
`bash ~/.local/share/harlan-github-agent/service/scripts/hogwild-service.sh update`.
After that upgrade, use the current repository helper.
Use `reload-external-watches` only for external watches and their issue cutoff.
Other configuration changes require Restart.
Call the Control API directly only when no matching CLI subcommand exists.
Its Basic-auth username is `agent`.
Read API response contracts before extracting fields.
For the Review endpoint, the array lives at `.runs`.
## Authority and deeper contracts
Read [Hogwild](../hogwild/SKILL.md) before host work.
For daily check-ins, use [daily-checkin](../daily-checkin/SKILL.md).
For Codex or OpenCode session audits, use [agent-retro](../agent-retro/SKILL.md).
Read [the controller contract](references/controller-contract.md) before changing Service policy, dispatch, configuration, or publication.
It owns repository eligibility, Approval, Review, Repair, releases, and conflict resolution.
Workers may edit only their assigned worktrees when authorized.
Workers never change GitHub state or Service-owned SQLite data.
The Controller owns credentials and every GitHub write.
Never approve a pull request.
Keep primary checkouts read only.
Report Service state, active subjects, active Tasks, and exact blockers.
Claim work started only when the Journal records it.
Files in this package (3)
- SKILL.md 6 KB
- agents/openai.yaml 1 KB
- references/controller-contract.md 34 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · harlan-zw/harlan-claude-code | 95 | MIT |
| harlan-zw/harlan-agent-kit | 95 | MIT |
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 6157a9e7bbca (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100adversarial-review
Review one pull request adversarially, hand permitted defects to Repair, verify the remote head, and publish the Harlan Agent Kit bot status. Use for rigorous pre-merge PR review. - 100agent-retro
Weekly retro of Harlan GitHub Agent sessions. Group transcripts by goal, find repeated and wasted work, and rank fixes to the controller, prompts, skills, or model. Use for agent retro, session review, agent efficiency, or self-improvement runs. - 100mcp-server-github
Use this skill when installing, configuring, and executing tools with the official GitHub MCP server for repository, issue, and PR management. - 100git-github
Use for any git or GitHub operation in the team repo — creating the repo from the template, branches, PRs with gh, issues, resolving conflicts, and recovering from mistakes. - 100github-maintainer
GitHub 仓库维护专用 agent。用户说「推上去」「提交」「建个仓库」「发个 release」「处理 issue/PR」「仓库改名」时使用。负责 git 提交、推送、建仓、改名、release、issue 管理,凭据已持久化,直接操作无需用户授权。 - 100github
The public GitHub repository `dvalnn/maestro` - syncing its `next` branch from the forge, landing a GitHub PR on the forge, crediting its contributor, and the one-time setup. Use when pushing to GitHub, when a GitHub PR or issue needs handling, or when a GitHub release is published.