autogrind

![autogrind-banner](https://static.ouorz.com/autogrind-banner-4.png)

**Tell your agent to start working. Walk away. Come back to finished work.**

AutoGrind is a skill for AI coding agents that makes them work _continuously and autonomously_, grinding through improvements, fixes, tests, and polish in repeating cycles until _you_ say stop. No hand-holding. No "should I continue?" No stopping because the TODO list looks empty.

Works for any long-running workflow: code, ML, research, design, writing.

Compatible with the [Agent Skills](https://agentskills.io) open standard; works across Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Windsurf, Roocode, Cline, Trae, Kimi Code, GitHub Copilot, Goose, AmpCode, Kilo, Kiro, Factory, Hermes Agent, and any skills-compatible agent. Each mechanism is grounded in published AI/ML research; see [RESEARCH.md](RESEARCH.md).

English | [简体中文](README.zh.md)

---

## Install

Paste this into any agent chat:

```
Please install the AutoGrind skill from https://github.com/ttttonyhe/autogrind.
Clone the repo, install the skill to the right location for my agent environment,
and confirm it is ready to use.
```

Then invoke it:

```
/autogrind
```

If you use Claude Code or Codex and prefer native plugins, see the [plugin installation guide](PLUGIN.md).

Remember to enable unrestricted tool use so AutoGrind can run commands, read files, and commit without per-call permission prompts. For example:

```bash
claude --dangerously-skip-permissions
```

Without this, AutoGrind pauses on every tool call. It works, but defeats the purpose.

<details>
<summary>Manual CLI installation</summary>

### Universal (all agents)

All agentskills.io-compatible agents discover skills from `~/.agents/skills/`. One install, all agents:

```bash
# Stable install — clone directly to the skills location
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind

# Or symlink from an existing clone (live updates)
git clone https://github.com/ttttonyhe/autogrind.git
ln -sfn "$(pwd)/autogrind" ~/.agents/skills/autogrind
```

---

### Claude Code

```bash
# Stable install — clone directly to the skills location
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.claude/skills/autogrind

# Or symlink from an existing clone (live updates)
ln -sfn "$(pwd)" ~/.claude/skills/autogrind
```

**Invoke:** `/autogrind` or `"keep working, don't stop"`

Optional native plugin (invoke with `/autogrind:start`):

```bash
claude plugin marketplace add ttttonyhe/autogrind && claude plugin install autogrind@autogrind
```

---

### Codex

Preferred native plugin path: open this repo in Codex, open `plugins`, and install `autogrind` from the AutoGrind marketplace. Full instructions: [PLUGIN.md](PLUGIN.md).

For direct skill install or local authoring/testing, the raw skill still works:

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

Codex discovers raw skills automatically from `~/.agents/skills/`. Enable full auto-approval in your Codex config so tool calls are not gated on confirmation.

**Invoke:** `"autogrind this project"` or `"keep working, don't stop"`

---

### Gemini CLI

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.gemini/skills/autogrind
# Or use the universal path: ~/.agents/skills/autogrind
```

Gemini CLI discovers skills automatically from `~/.gemini/skills/` — no GEMINI.md entry required. For local development, use `gemini skills link` to symlink.

**Invoke:** `gemini "autogrind this project, don't stop until I say so"`

---

### OpenCode

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
# Or: ~/.claude/skills/autogrind (OpenCode checks both)
```

OpenCode discovers skills automatically — no AGENTS.md entry required.

**Invoke:** `opencode "autogrind this project, keep going until I say stop"`

---

### Cursor

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.cursor/skills/autogrind
# Or use the universal path: ~/.agents/skills/autogrind
```

Enable auto-run for terminal commands in Cursor settings.

**Invoke:** `"Keep working on this project autonomously. Don't stop."`

---

### Windsurf

```bash
# Preferred path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.codeium/windsurf/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this project, don't stop"`

---

### Roocode

```bash
# Preferred path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.roo/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"Keep working, don't stop"`

---

### Cline

```bash
# Preferred path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.cline/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this project, keep going"`

---

### Trae

```bash
# Preferred path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.trae/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this, don't stop"` or `/autogrind`

---

### Kimi Code

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.config/agents/skills/autogrind
# Or project-level
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git .kimi/skills/autogrind
```

**Invoke:** `/skill:autogrind` or `"keep working, don't stop"`

---

### GitHub Copilot

```bash
# Preferred paths
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.copilot/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

Pair with a `.github/copilot-instructions.md` file to give Copilot project context.

**Invoke:** `"autogrind mode — keep working autonomously"` or `/autogrind`

---

### Goose

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this project, keep going"`

---

### AmpCode

```bash
# Preferred path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.config/agents/skills/autogrind
# Or universal path
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this, don't stop"`

---

### Kilo / Kiro / Factory

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

All support the agentskills.io universal path. Install once, invoke directly.

**Invoke:** `"Keep working on this project. Don't stop."` or `"autogrind"`

---

### Hermes Agent (NousResearch)

```bash
git clone --depth 1 https://github.com/ttttonyhe/autogrind.git ~/.agents/skills/autogrind
```

**Invoke:** `"autogrind this, keep going"`

</details>

### Install via Plugins

If you prefer native plugin UX on Claude Code or Codex, use the install paths in [PLUGIN.md](PLUGIN.md). Both native plugins wrap the same `autogrind` skill instead of replacing it.

---

## Update

Paste this into any agent chat:

```
Please update the AutoGrind skill to the latest version from https://github.com/ttttonyhe/autogrind.
```

<details>
<summary>Manual update</summary>

```bash
# If installed as symlink — pull in the source repo.

# If installed via git clone, pull inside the install location:
cd ~/.claude/skills/autogrind && git pull    # Claude Code
cd ~/.agents/skills/autogrind && git pull    # Universal / Codex / Gemini / OpenCode / Cursor
```

</details>

---

## The Grind Cycle

```mermaid
flowchart TD
    INIT["INIT (once)\nDetect guidance files\nExtract goals and conventions"]
    OV["1. OVERVIEW\nAssess project state"]
  

[truncated…]