the self-evolving repository

Let agents own your repo.

Mention @sepo-agent anywhere on GitHub and it answers, implements, reviews, and fixes your code. Every exchange lands as structured work — issues, PRs, and comments you can reference, search, and share across teams. And it grows with you: the agent memorizes project context, extracts your rubrics, and improves the next run.

why a self-evolving repo

Sepo makes agent work structured and verifiable for long-horizon tasks.

level of agent supportinteraction timehoursdaysdays → weeks
hours

Interact with coding agents in issues, PRs, and discussions

  • Agent work becomes traceable and supports easy cross-references to past sessions via issues & PRs
  • Shared by the team — humans and agents read the same record
  • Code changes are guardrailed by the harness — so no surprises
days

The agent learns your rubrics and accumulates memory

  • Agent work and runs are stored on the agent/memory branch
  • Sepo distills shared lessons into rubrics from your past discussions and code reviews
  • Future implementations are steered by those rubrics to reduce wasted user effort
days → weeks

The agent self-improves the repo with easy supervision and verification

  • Scheduled jobs have agents regularly self-inspect the code and come up with improvements
  • Orchestrate long-form agent tasks in PRs and sub-issues for easy human supervision and inspection

why a self-evolving repo

Sepo makes agent work structured and verifiable for long-horizon tasks.

level of agent supportinteraction timehoursdaysdays → weeks
hours

Interact with coding agents in issues, PRs, and discussions

  • Agent work becomes traceable and supports easy cross-references to past sessions via issues & PRs
  • Shared by the team — humans and agents read the same record
  • Code changes are guardrailed by the harness — so no surprises

why a self-evolving repo

Sepo makes agent work structured and verifiable for long-horizon tasks.

level of agent supportinteraction timehoursdaysdays → weeks
hours

Interact with coding agents in issues, PRs, and discussions

  • Agent work becomes traceable and supports easy cross-references to past sessions via issues & PRs
  • Shared by the team — humans and agents read the same record
  • Code changes are guardrailed by the harness — so no surprises
days

The agent learns your rubrics and accumulates memory

  • Agent work and runs are stored on the agent/memory branch
  • Sepo distills shared lessons into rubrics from your past discussions and code reviews
  • Future implementations are steered by those rubrics to reduce wasted user effort
days → weeks

The agent self-improves the repo with easy supervision and verification

  • Scheduled jobs have agents regularly self-inspect the code and come up with improvements
  • Orchestrate long-form agent tasks in PRs and sub-issues for easy human supervision and inspection

how it works

Just mention @sepo-agent on GitHub

with the Sepo app installed on your repo

issue #8 · api-client
miaMember2 min ago
@sepo-agent why do the timeout tests only flake on CI, never locally?

Any issue or PR is a prompt — just write a comment.

how it works

Just mention @sepo-agent on GitHub

with the Sepo app installed on your repo

1

Mention it with a question

Tag @sepo-agent in any issue or PR. The 👀 reaction lands in seconds, progress streams into one live comment, and the answer arrives in the thread.

issue #8 · api-client
miaMember2 min ago
@sepo-agent why do the timeout tests only flake on CI, never locally?
👀 1
sepo-agentAppjust now
CI runners cap at 2 vCPUs, so the 50ms timeout in client.test.ts races the event loop under load. Two fixes below, with links to the runs that show it.

👀 in seconds, progress in one live comment, then the answer.

2

/implement — request to pull request

Describe what you want in the issue. Sepo opens a fresh branch and fires a new PR that implements it, linked back to the request.

issue #12 · api-client
miaMember8 min ago
@sepo-agent /implement add retry with backoff to the API client.
👀 1
actions · agent-implement
Agent / ImplementGitHub Actions · agent/implement-issue-12
pull request #13

Add retry with backoff to API client #13

sepo-agent · fixes #12

The result is a pull request, linked back to the issue that asked.

3

/review and /fix-pr — finish an existing PR

On any open PR: /review scores it against your rubrics; /fix-pr picks up what's missing and pushes the fix.

pull request #13

Add retry with backoff to API client #13

sepo-agent · fixes #12

rubric · tests cover new pathspass
rubric · explicit timeoutsfailed
sepo-agentAppjust now
minor_issuescode quality review
  • clean separation of retry policy from the client
  • tests cover the happy path and timeouts
  • missing max-attempts guard in retry.ts

Rubric checks plus a code-quality review — verdict: minor issues.

4

/orchestrate — loop until it's done

A focused issue runs implement → review → fix-pr until the rubrics pass — then the loop stops and requests your review.

pull request #14

Harden the API client against flaky networks #14

sepo-agent · round 1 · fixes #21

Sepo is dispatching follow-up automation.

source
orchestrate
next
review
target
PR #14
round
2 / 40
status
Dispatched
rubric · explicit timeoutsfailed

Every hop is dispatched in the open — next: review.

5

/orchestrate a large task — fan out sub-issues

A big issue gets broken into focused sub-issues, each launched as its own PR and orchestrated on its own loop.

issue #25 · epic
miaMemberjust now
@sepo-agent /orchestrate migrate the api-client to the v2 SDK — break it into focused PRs.

sub-issues

#26swap the auth handshake to v2PR #15 · finished
#27migrate retry + backoff configcreated

Sepo is dispatching follow-up automation.

source
orchestrate
next
implement
target
issue #26
round
1 / 40
status
Dispatched
Sepo finished the work — opened PR #15 for issue #26

Sepo is dispatching follow-up automation.

source
orchestrate
next
implement
target
issue #27
round
2 / 40
status
Dispatched

Then the follow-up — the next round is dispatched.

goals & self-improvement

From user-driven implementation to agent self-improvement.

As Sepo learns from your interactions, it can start self-improving the codebase with scheduled jobs: it looks through the code and finds areas of improvement automatically, or optimizes for explicit goals set in the repo. Again, every change is tracked and organized in structured form — issues and PRs. You can review and approve each change manually, or optionally let the agent self-approve and merge.

actions · scheduled

Goal: harden api-client reliability

agent/goal-checkcron · nightly
Review pass → gap: retry paths under-testedhandoff 1
Issue #31 opened — raise retry coveragehandoff 2
Implement → PR #32 openedhandoff 3
review ↔ fix loop
Merged — goal re-checkedhandoff 4
goal satisfied · next check tonight

get started

Three steps to a self-evolving repo.

  1. Start with the setup guiderecommended

    The best way to start: the Sepo setup guide walks you through everything below in one flow.

  2. Use the template

    Create a new repository from self-evolving/repo — or install Sepo into an existing one.

  3. Install the app, add a key

    Install the Sepo GitHub App, then add a model credential — OPENAI_API_KEY or ANTHROPIC_API_KEY — as an Actions secret.

  4. Mention the agent

    Open an issue and write @sepo-agent. The 👀 reaction means its already working.

quick start
$ gh repo create my-app --template self-evolving/repo
✓ Created repository my-app
$ gh secret set ANTHROPIC_API_KEY
✓ Secret stored
# then, in any issue:
@sepo-agent /implement issue #1
👀 Sepo is working…