# OneCue — Context intelligence for software projects

> OneCue brings relevant decisions from your project docs and past sessions into your coding agent’s context, before it starts making changes. One relevant cue, with its source — or silence. Local-first; OneCue’s store never leaves your machine.

Your agents learn. OneCue remembers.

OneCue is the context intelligence layer between a software project and the
coding agents that work on it. The project already paid to learn things — an
incident was debugged, an architecture selected, an approach rejected. The next
task can repeat that work or miss the constraint. OneCue keeps the decision,
its reason, and its evidence, then surfaces at most one relevant cue on the
next prompt. Silence is a successful result when nothing applies.

## How it works

1. The project learns something — a debugging discovery, a rejected approach,
   an architectural constraint.
2. OneCue saves it as a small record: the lesson, its reason, and the source it
   came from.
3. On a later prompt, recall selects the one cue that should change the next
   action — or stays silent for unrelated work.
4. Planned: a background loop verifies saved lessons against changing code,
   reconnects evidence, and refines the cue.

## What exists today

- A free local skill that teaches Claude Code (and Devin) to capture and recall
  project memory as readable Markdown under `.onecue/memories/`.
- The `onecue` CLI: lifecycle hooks write and consult the store automatically;
  `onecue doctor` verifies the setup.
- Works with Claude Code and Devin. Codex, Cursor, Gemini CLI, and OpenCode
  support is planned through hooks, skills, and MCP integrations.

## Planned, not shipped

- OneCue Cloud: shared project intelligence across machines and teammates.
- The doctor context-spend report: a diagnostic showing where context spend is
  repeated or avoidable. Sample figures on the site are illustrative, not
  measured results.
- Background verification and enrichment of saved knowledge.

## Install

```sh
curl -fsSL https://onecue.sh/install.sh | sh
```

Alternatives: `npm i -g onecue-cli` then `onecue install`, or skill-only via
`npx skills add onecueai/onecue-skill`.

## Pages

- [Install and start](https://onecue.sh/start)
- [Session examples](https://onecue.sh/examples)
- [OneCue Cloud](https://onecue.sh/cloud)
- [About](https://onecue.sh/about) · [Contact](https://onecue.sh/contact) · [Privacy](https://onecue.sh/privacy)
- [llms.txt](https://onecue.sh/llms.txt) · [Sitemap](https://onecue.sh/sitemap.xml)
- [GitHub](https://github.com/onecueai/onecue-skill)