Coding Friend

Claude Code Plugin

Disciplined Engineering Workflows

A lean toolkit that enforces TDD, systematic debugging, smart commits, code review, and knowledge capture across your engineering workflow.

Plugin+CLI+Learn Host+Learn MCP+CF Memory
Early stage — expect rough edges and frequent changes. Want to shape it? Join us on GitHub.
17+
Skills/Commands
6
Agents
8
Hooks

What makes it different

Three principles that set Coding Friend apart from every other AI workflow tool.

Radical Simplicity

Install once. Start using immediately.

Most workflow tools require complex setup or hours of configuration. Coding Friend is the opposite — install once, use everywhere, with plain text skills you can read and edit anytime.

One install, every project

npm install once. The plugin loads into Claude Code automatically. No per-project configuration required.

Plain text skills

Skills are Markdown files. No DSL to learn. Read them, edit them, share them — they're just text.

Zero friction workflows

Type /cf-plan and start. Auto-invoked skills activate in the background — TDD, debugging, verification — without a thought.

Multi-platform out of the boxcoming soon

Works with Cursor, Windsurf, Copilot, Roo Code, and more. One toolkit, every AI coding tool.

Read more

/cf-learn

Your knowledge, amplified.

Vibe-coding is fast — but you risk learning nothing. Every session generates insights you never write down. /cf-learn captures them as human-readable docs, so you actually understand what was built — not just the AI.

terminal
$ /cf-learn JWT Authentication
Extracting knowledge from session...
📄 JWT Authentication Patterns
├── Token validation flow
├── Middleware composition
└── Error handling strategies
Saved docs/learn/Web_Dev/jwt-auth.md
$ cf host # Browse as website
$ cf mcp # Feed into any LLM
Auto-invoked during sessionsCategorized by topicHost as websiteMCP-ready
Read more

CF Memory

AI that remembers your project.

Every AI session starts from scratch — repeating the same mistakes, forgetting past decisions, losing debug knowledge. CF Memory gives your AI persistent, searchable memory across sessions — so it learns from your project over time.

terminal
$ cf memory status
Tier 1 (SQLite + Hybrid Search)
Memories: 47 │ Daemon: running
Index: FTS5 + sqlite-vec (384d)
$ cf memory search "auth middleware"
┌─ 0.94 Auth middleware uses JWT httpOnly
├─ 0.87 CORS fix: missing Origin header
└─ 0.81 Session rotation on refresh
Skills auto-recall relevant memories
before every task via MCP.

3-tier graceful degradation

SQLite + vectors when available, MiniSearch in-memory as fallback, pure grep as baseline. Always works, even offline.

Hybrid search (BM25 + semantic)

Keyword precision meets semantic understanding. Find memories even when you paraphrase — RRF fusion ranks the best results.

Auto-capture from skills

cf-fix, cf-sys-debug, cf-review, and cf-ask automatically store debug episodes, architectural insights, and solutions.

100% local, markdown source of truth

No cloud, no API keys. Your memories live as plain markdown files you can read, edit, and version-control.

Read more

Workflow in action

Skills and agents work together automatically.

Main flowAuto-InvokedAgents

Plus utility skills: /cf-ask, /cf-remember, /cf-research, /cf-session, /cf-help

CF Memory
01

/cf-plan

Brainstorm your approach. Explores the codebase, identifies patterns, and writes a structured plan.

cf-explorercf-planner
02

cf-tdd

TDD workflow enforced. Every feature starts with a failing test, then implementation, then refactor.

cf-explorercf-implementer/cf-fixcf-sys-debug
03

/cf-review

Multi-layer code review in a separate subagent. Checks security, performance, style, and coverage.

cf-code-reviewer/cf-optimizecf-auto-review
04

/cf-commit

Smart conventional commit. Analyzes staged changes and writes a meaningful commit message.

cf-verification
loop back to cf-tdd
05

/cf-ship

One command to verify, commit, push, and create a pull request. Smart conventional commits included.

cf-writer/cf-learn

Memory Architecture

3-tier graceful degradation — always works, even without heavy dependencies. See Memory System for more details.

Claude CodeSession

Your AI coding session. Skills like /cf-fix, /cf-ask, and /cf-remember trigger memory operations automatically.

MCP Serverstdio

Central routing hub. Detects the best available backend (SQLite → Daemon → Grep) and routes all 6 memory tools directly to it.

selects best backend
1
SQLiteFTS5 + sqlite-vec + RRF
direct

Full hybrid search with semantic vectors

fallback
2
MiniSearchBM25 + fuzzy matching
via Daemon

In-memory index hosted by background daemon (Hono + UDS)

fallback
3
Grepfile scan
direct

Zero deps, always available

Markdown Filesdocs/memory/*.md

Source of truth. Human-readable markdown with YAML frontmatter. Git-trackable, portable, never locked in.

Features

Beyond skills — the tools and systems that power your workflow.

Always know what's happening. Your terminal statusline, upgraded with real-time project context — version, branch, model, context usage, and rate limits at a glance. Read more about it here.

claude — coding-friend
claude[12:47:44]
    |
   ▟█▙     Claude Code v2.1.50
 ▐▛███▜▌   Opus 4.6 · Claude Max
▝▜█████▛▘  ~/git/coding-friend
  ▘▘ ▝▝
Try "how do I log an error?"
cf v0.3.0coding-friend (⎇ main)Opus (1M)
ctx 42%[5h] 30% → 2:30pm[7d] 10% → mar 15, 2:30pm
cf v0.3.0CF version
coding-friend (⎇ main)Project + Branch
Opus (1M)Model
ctx 42%Context
[5h] 30% → 2:30pm | [7d] 10% → mar 15, 2:30pmRate limit

Run cf statusline to set up in seconds.

/cf-learn extracts human-readable knowledge from your coding sessions. Then cf host turns those docs into a searchable static website you can browse locally or deploy anywhere.

/cf-learn

Extract knowledge

docs/learn/

Markdown files

cf host

Static website

Learn Host — browsable knowledge base generated from /cf-learn docs
Categorized by topicFull-text searchTag-based filteringDeploy anywhere

Save your Claude Code session to a portable markdown file and resume it on any machine. Perfect for switching between desktop and laptop, or handing off work to a teammate.

/cf-session

Save current session context, messages, and file changes to docs/sessions/.

cf session load

Restore a saved session on any machine — pick up exactly where you left off

terminal
$ /cf-session
Saving current session...
📋 Session Summary
├── 47 messages, 3 files changed
├── Context: auth middleware refactor
└── Branch: feat/jwt-auth
Saved docs/sessions/2026-03-17_jwt-auth.md
$ cf session load docs/sessions/2026-03-17_jwt-auth.md
Restoring session context...
✓ Session loaded — continue where you left off

Every AI session starts from scratch — repeating mistakes, forgetting decisions. CF Memory gives your AI persistent, searchable memory across sessions with 3-tier graceful degradation.

Tier 1

SQLite

FTS5 + semantic vectors with RRF fusion

Tier 2

MiniSearch

In-memory BM25 + fuzzy matching via daemon

Tier 3

Grep

Zero-dependency file scan, always available

Auto-capture from skills

cf-fix, cf-review, cf-ask automatically store debug episodes and architectural insights.

Hybrid search (BM25 + semantic)

Find memories even when you paraphrase — Reciprocal Rank Fusion ranks the best results.

100% local, markdown source of truth

No cloud, no API keys. Human-readable markdown with YAML frontmatter, git-trackable.

MCP integration

Skills auto-recall relevant memories before every task via the MCP server.

Skills are your commands — type /cf-plan and Coding Friend handles the rest. Behind the scenes, agents do the heavy lifting: specialized subprocesses that explore, plan, review, and write autonomously.

13 Slash Commands

Manual triggering with natural language

/cf-plan/cf-fix/cf-ask/cf-review/cf-commit/cf-ship/cf-optimize/cf-scan/cf-remember/cf-learn/cf-research/cf-session/cf-help

4 Auto-Invoked Skills

Activate automatically when relevant — TDD, debugging, verification, code review

6 Specialized Agents

Autonomous subprocesses for parallel work

cf-explorerCodebase exploration (read-only, fast)
cf-plannerTask decomposition & brainstorming
cf-implementerTDD implementation in isolation
cf-code-reviewerMulti-layer code review
cf-writerLightweight doc generation
cf-writer-deepDeep reasoning for nuanced content

Skills orchestrate agents behind the scenes — /cf-review dispatches cf-code-reviewer, /cf-plan uses cf-planner + cf-explorer.

/slash skills

Manual triggering with natural language. Coding Friend handles the rest.

Custom skill guides

Extend any built-in skill with your own rules. Add steps before, after, or throughout any workflow.

.coding-friend/skills/cf-commit-custom/SKILL.md
## Before
- Check branch naming convention
## Rules
- Always include ticket number in subject
## After
- Run tests if commit type is feat: or fix:
## Before

Runs before the builtin workflow starts

## Rules

Additional rules applied throughout

## After

Runs after the final step completes

Create .coding-friend/skills/<skill-name>-custom/SKILL.md to customize any skill.

Get started in 3 steps

Install once, use in every project. Supports user, project, and local scopes. More details in the documentation.

1Install CLI
npm i -g coding-friend-cli
2Install Plugin
cf install
3Initialize Workspace
cf init