月ノ目

tsukinome

The moon's eye over your codebase.

A GitHub-native agent that turns a plain-English issue into a high-quality, test-first pull request — with you in the loop at every gate.

View on GitHub Connect on LinkedIn
The pipeline

From an issue to a reviewed PR.

You describe the change in plain English. Tsukinome does the rest — and stops for you at the moments that matter.

01

Spec

Drafts a functional spec with testable acceptance criteria, committed to the repo.

02

Clarify

Asks one batched set of questions — only when something genuinely can't be inferred.

03

Plan

Commits an implementation plan and waits. You reply /approve before any code is written.

04

Build

Implements test-first — red → green → refactor, one commit per task, in an isolated sandbox.

05

Review

Self-reviews the diff, then opens a pull request with the spec, plan, and tests attached.

06

Iterate

Actionable PR review comments trigger a bounded, test-first fix loop — never runaway.

What we're fixing

The agent workflow, done right.

Most code agents are fire-and-forget scripts that dump your whole repo into a context window. Tsukinome is built on three deliberate choices.

Human-in-the-loop

A GitHub App, not a GitHub Action.

Runs on a persistent backend, so a run can suspend and resume across human gates — clarify, approve, review — for days. A stateless Action can't hold that state. You approve the plan before a single line is written.

Token-lean

Retrieval, not repo dumps.

CocoIndex + pgvector give the agents semantic retrieval of just the relevant code, instead of stuffing the whole repo into the prompt. Model tiering — Haiku, Sonnet, Opus — plus prompt caching keep every run cheap and metered.

Lightweight

Install once. No config.

No per-repo config files, no workflow YAML, no CI wiring. Install the GitHub App once and open an issue — it just works, on any supported repo.

Under the hood

A disciplined, modern stack.

Every external dependency sits behind an interface with a real implementation and a fake — the whole pipeline is unit-tested without a single key.

TypeScript
end to end
GitHub App
Probot + Octokit
Postgres · Neon
state + pgvector
CocoIndex
tree-sitter semantic index
E2B sandbox
ephemeral microVMs
Anthropic Claude
Haiku / Sonnet / Opus
Test-first
TDD is a hard mechanical gate
$/run
every call metered, budget-capped
Zero-config
install the App, open an issue
Get started

Up and running in minutes.

No workflow files, no CI wiring. Install the App, open an issue, and stay in control of every gate.

1

Install the GitHub App

One click from the GitHub Marketplace. Pick the repositories you want Tsukinome to work on — it needs read/write on issues, pull requests, and contents. No files added to your repo.

2

Open an issue

Describe the change in plain English — a bug, a small feature, a refactor. Tsukinome acknowledges it, then drafts a spec with testable acceptance criteria.

3

Answer any questions

If something genuinely can't be inferred, it asks one batched set of clarifying questions right in the issue thread. Reply, and it refines the spec.

4

Approve the plan

It commits an implementation plan and waits. Nothing gets built until you say so.

/approve # start implementation /abort # stop and close out # …or just describe what to change
5

Review & merge the PR

A self-reviewed, test-first pull request lands — spec, plan, and tests attached, with a per-run cost summary. Leave review comments for a bounded fix loop, or merge.

月ノ目

Let the moon's eye
watch your repo.

An experiment in agentic engineering that keeps humans in command.