# ClineFlow — Git-native project memory for coding agents, stored as Markdown and YAML in your own repo.

> Source: AgentsIndex — https://agentsindex.ai/clineflow (structured, researched, re-verified)
> Facts last verified: 2026-10-19

ClineFlow is an MIT-licensed, project-local memory layer that installs into a repository and keeps specs, goals, decisions, verification and handoffs in a Git-versioned Open Knowledge Format bundle. Supported coding agents read and update it through their native instruction files.

| Fact | Value |
| --- | --- |
| Website | https://clineflow.com/ |
| Price | Free |
| Free tier | Yes |

Entire tool is MIT-licensed and installed from the public repository; no account, hosted service or paid tier exists. Requires Git and curl or wget.

## What it costs to start

**Free tier** · Yes — The whole tool is MIT-licensed and installed from a public repository with no account or hosted service in the path, so there is nothing to pay for.

> ClineFlow installs a project-local durable development workflow. It does not require an account, hosted memory service, or always-running process.
> — https://github.com/hassanvfx/clineflow/blob/main/docs/installation-and-lifecycle.md · Installation and Lifecycle, opening paragraph

## How you build with it

**Public API** · No — The documented interfaces are local shell commands and files in your repository; the vendor states the contract itself is Markdown, YAML, links and Git rather than a service you call.

> No Codex plugin, proprietary service, or always-running ClineFlow process is required. The durable contract is Markdown, YAML, links, and Git.
> — https://github.com/hassanvfx/clineflow · README, "Works with your agent" section

**MCP server** · No — Integration happens by writing instruction blocks into agent config files, and the vendor states no plugin or running process is involved, so there is no MCP server for an assistant to call.

> No Codex plugin, proprietary service, or always-running ClineFlow process is required.
> — https://github.com/hassanvfx/clineflow · README, "Works with your agent" section

**Open source** · Yes — The repository publishes the installer, validators and knowledge templates under the MIT license, and GitHub reports MIT as the license for the project.

> [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
> — https://github.com/hassanvfx/clineflow · README badge row, License badge

## What it actually installs

ClineFlow is a shell-script installer, not a hosted service. Run one prompt or a curl/PowerShell one-liner from a project directory and it drops a hidden `.clineflow/` runtime (installer, updater, validators) plus a `knowledge/` directory into the repo, then appends one marker-delimited instruction block to each supported agent's native config file: `.clinerules` for Cline, `AGENTS.md` for Codex and Cursor, `CLAUDE.md` for Claude Code, `.github/copilot-instructions.md` for Copilot, and `.windsurf/rules/clineflow.md` for Windsurf. Existing content in those files outside the marker block is left alone. There is no daemon, no account, and no network call at runtime beyond the install/update fetch from GitHub.

## The memory model: five ledgers, not a vector store

Project memory lives as plain Markdown and YAML in the repo, not in an embedding index. Five small YAML files (`clineflow_goals.yml`, `clineflow_specification.yml`, `clineflow_verification.yml`, `clineflow_last_session.yml`, `clineflow_timeline.yml`) are meant to answer 'why, what, proven how, what's true now, and how did we get here' at a glance, and each substantial task gets a longer-form Engineering Journal file under `knowledge/journals/`. Saying 'please commit' triggers the agent to update the active journal, refresh all five ledgers with one shared timestamp, and run a bundled validator (`validate-knowledge-sync --staged`) before the commit is created. The format follows Google Cloud's Open Knowledge Format (OKF) v0.2 spec, a real, actively maintained Apache-2.0 project (9,100+ stars) for making agent-generated knowledge self-describing.

## OKF conformance is self-declared, not certified

The README carries an 'OKF v0.2' badge and the repo ships its own OKF and knowledge-sync validators, but there is no independent body certifying conformance — the badge and the checks are both authored by the same maintainer. This is normal for how OKF is designed to work (no central registry, no required tooling) but it means 'OKF-compatible' here is a claim you can verify yourself by reading the spec against the repo, not one a third party has signed off on.

## Maturity: near-solo, very early, and its own CI is red

The repo was created 2025-11-08 and has 1 star, 0 forks, and 0 open issues as of 2026-09-07. GitHub's contributor graph lists two accounts, but the second (`aeonfluxor`, 73 of the commits) is an unidentifiable account with no name, bio, company, or followers and only one public repo — there's no way to confirm it's a distinct person rather than the same maintainer's second account or an automated identity. Treat this as effectively a one-person project until shown otherwise. More concretely checkable: the last three runs of the project's own GitHub Actions test suite on `main` (as of 2026-09-07) all report `conclusion: failure`, driven by a `windows-lifecycle-smoke` job failing at its 'Install through Git Bash' step on every run in that window, even though Windows is one of the three officially supported install paths.

## The marketing domain no longer hosts the product page

clineflow.com and www.clineflow.com both return HTTP 301 to `https://hassanvfx.github.io/infinite-ai-context/`, a GitHub Pages site that still displays the ClineFlow name and installs the same tool. Public RDAP records show clineflow.com was registered on 2026-08-20 — the redirect to GitHub Pages was therefore already in place well within a month of the domain's own registration. The GitHub Pages destination is legitimate (same author, same GitHub repo link, same install prompt) and not a broken link, but a buyer bookmarking clineflow.com should expect to land on a github.io URL, not the branded domain.

## Cost

The tool itself is free: MIT-licensed, no account, no hosted tier, no usage limits, confirmed against the repository's LICENSE file and GitHub API metadata. The only paid artifact in the ecosystem is the author's companion book, 'Infinite AI Context: ClineFlow and Google's Open Knowledge Format' — $43.04 for a 159-page paperback on Lulu as of 2026-09-08, with a free web PDF also linked from the product page. Buying the book is optional and has no bearing on what the software does.

## Repository

| Fact | Value |
| --- | --- |
| Licence | MIT |
| Stars | 1 |
| Last push | 2026-09-12 |

## Coverage elsewhere

| Source | Kind | Read |
| --- | --- | --- |
| rdap.org | Independent source | undated |
| hassanvfx.github.io | A competitor's comparison | undated |
| api.github.com | Repository | undated |
| zenodo.org | Independent source | undated |
| api.github.com | Repository | undated |
| api.github.com | Repository | undated |
| api.github.com | Repository | undated |
| lulu.com | Independent source | undated |

## What changed

- 2026-10-19 — Free tier · Price · What it does

## Keeping it current

These facts are re-checked against ClineFlow's own pages and updated when they change. If you represent ClineFlow, sign in and update the listing from your dashboard at https://agentsindex.ai/dashboard. The operations this site accepts from an agent are listed at https://agentsindex.ai/.well-known/agents.json — that catalog needs no key to read, and each entry states its own auth.
