FDEOps is a JavaScript tool that acts as a memory system for Forward Deployed Engineers, storing client engagements in a local fieldbook and providing CLI/adapter integration. Latest releases update the embedding/record-keeping workflow and input hygiene rules. Installation and binding steps are provided in the README.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
FDEOps is described as a local memory system for engagements, using a fieldbook (.fde/) with one folder per client. It supports working with an AI coding agent via an optional CLI and various adapters, and emphasizes storing a dated, sourced record of engagement decisions and progress. It includes a lifecycle workflow (land, discover, plan, build, ship, close) and a UI for the fieldbook.
How it works
- The fieldbook acts as the system of record for embeds, with files such as context.md, brief.md, reality.md, decisions.md, etc., all dated and sourced.
- You describe situations with @fde, and the session start/end hooks load where you left off and capture changes.
- A local CLI handles memory writes, search, and status without model tokens; the agent runs it.
- The tool allows switching coding agents while preserving the same client record, via bindings and resume/init workflows.
Getting started
1. Install (pick one)
npx skills add suboss87/fdeops # Cursor, Codex, and skills-compatible agents
/plugin marketplace add suboss87/fdeops # Claude Code
/plugin install fdeops@fdeops
2. Bind once - inside the client workspace (setup only; not a daily habit):
npx fdeops resume --init garvey # creates ~/fde-engagements/garvey engagement + binds workspace
Check it worked:
npx fdeops resume # prints a short "where we are" for this client
3. Work - talk normally:
@fde I just got the brief. New client, payments platform, they want it live before their Q3 audit.
@fde routes and updates the fieldbook - you confirm judgment. Full workflow: docs/USAGE.md.
## Recent releases
- v3.9.16 fdeops 3.9.16 (2026-07-21): Intent vs diff gate; scope-creep detector fitted into existing `@fde` ship + review. Highlights include KEEP / JUSTIFY / SPLIT / DROP every path against the stated slice before.
- v3.9.15 fdeops 3.9.15 (2026-07-21): Input hygiene; strip ANSI / control chars on write/read; refuse binary/debrief notes; `.fde` as a file fails loud.
- v3.9.14 fdeops 3.9.14 (2026-07-21): Field-validation follow-ups; corrupt `.fde/.git` is a loud doctor issue; smart debrief: c.
- v3.9.13 fdeops 3.9.13 (2026-07-21): Audit → eval → deploy loop; optional AI eval pack; ship/close.
- v3.9.12 fdeops 3.9.12 (2026-07-21): Honest privacy wording for `<private>` tags.
Install example from latest release:
```bash
npm i -g fdeops@3.9.12
npx skills add suboss87/fdeops
Traction
Stars: 303; Forks: 27; Open issues: 2; Last push: 2026-07-21. Stars_1d: 0.
Caveats
License: MIT. Requires Node.js >= 18 for the CLI and adapters. Local-only, no network calls or telemetry by design.
Behind the repo
Subash Natarajan maintains the project.