Coding FriendCoding Friendbeta
Coding Friend

Claude Code + Codex CLI

Disciplined Engineering Workflows

A lean toolkit for systematic debugging, smart commits, code review, and knowledge capture — with optional TDD support across your engineering workflow.

Claude Code+Codex CLIbeta+Plugin+CLI+Learn Host+Learn MCP+CF Memory
Beta — core features are stable, feedback welcome. Want to shape it? Join us on GitHub.
Get StartedView on GitHub
21+
Skills & Commands
12+
Specialized Agents
2
Supported Hosts

The Ecosystem

Two supported hosts, five tools, one cohesive workflow. The plugin is the heart — the rest amplify what you build.

Claude Code
Codex CLIbeta
Principal
/cf-* skills

Plugin

Marketplace Plugin

The core — skills, agents, hooks, and commands that enforce disciplined workflows inside Claude Code and Codex CLI.

cf command

CLI

coding-friend-cli

Install and manage the plugin, initialize projects, set up statusline, and run the learn host — all from one binary.

cf memory

CF Memory

AI Memory System

Persistent memory for AI sessions — store, search, and recall project knowledge across conversations with hybrid search (BM25 + semantic).

cf learn host

Learn Host

Knowledge Website

Turn your /cf-learn and /cf-teach docs into a searchable static website. Host your knowledge base locally or deploy it anywhere.

cf mcp

Learn MCP

MCP Knowledge Server

Expose your /cf-learn and /cf-teach docs as an MCP server — feed your knowledge base directly into any LLM client that supports MCP (e.g. ChatGPT, claude.ai,...).

Features

Beyond Skills & Agents — the tools and systems that power your workflow.

Statusline

Always know what's happening. Your terminal statusline, upgraded with real-time project context — version, branch, model, account, 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?"
Opus (1M)
cf v0.3.0│coding-friend (⎇ main)│👤 Thi Dinh (me@dinhanhthi.com)
ctx 42%│[5h] 30% → 2:30pm│[7d] 10% → mar 15, 2:30pm
🆔 a1b2c3d4-e5f6-7890-abcd-ef1234567890
📋 Tasks: 2/5│🤖 Agent: cf-reviewer
Opus (1M)Model
cf v0.3.0CF version
coding-friend (⎇ main)Project + Branch
👤 Thi Dinh (thi@…)Account
ctx 42%Context
[5h] 30% → 2:30pm | [7d] 10% → mar 15, 2:30pmRate limit
🆔 a1b2c3d4-e5f6-7890-abcd-ef1234567890Session ID

Run cf statusline to set up in seconds.

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 phased plan with parallel execution.

cf-explorercf-planner
02

cf-tdd

Implementation workflow. Direct code by default — or add --add-tests for TDD: failing test first, 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-reviewer/cf-optimize
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.

/slash skills

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

/cf-ask
updatedHigh> 3,000 tokens injected into prompt

Ask

Quick Q&A about your codebase with persistent memory

/cf-commit
updatedLow< 1,500 tokens injected into prompt

Commit

Smart conventional commits with diff analysis

/cf-design
betaMedium1,500 – 3,000 tokens injected into prompt

Design

Scan existing UI patterns, design new components, or modify UI while keeping everything visually consistent.

/cf-fix
updatedHigh> 3,000 tokens injected into prompt

Fix

Quick bug fix workflow with problem verification and approach confirmation

/cf-help
updatedHigh> 3,000 tokens injected into prompt

Help

Answer questions about Coding Friend — skills, agents, workflows. Also auto-invoked when you ask naturally.

/cf-learn
updatedMedium1,500 – 3,000 tokens injected into prompt

Learn

Extract human learning docs from vibe coding sessions

/cf-optimize
updatedMedium1,500 – 3,000 tokens injected into prompt

Optimize

Structured optimization with before/after measurement

/cf-plan
updatedHigh> 3,000 tokens injected into prompt

Plan

Brainstorm and create phased implementation plans with parallel execution

/cf-remember
updatedHigh> 3,000 tokens injected into prompt

Remember

Capture project knowledge for AI memory across sessions

/cf-research
updatedHigh> 3,000 tokens injected into prompt

Research

In-depth research with web search and parallel subagents

/cf-review
updatedHigh> 3,000 tokens injected into prompt

Review

Multi-layer code review in a forked subagent

/cf-review-in
updatedMedium1,500 – 3,000 tokens injected into prompt

Review In

Collect and act on review results from an external AI agent

/cf-review-out
updatedLow< 1,500 tokens injected into prompt

Review Out

Generate a review prompt for an external AI agent (Gemini, Codex, etc.)

/cf-scan
updatedHigh> 3,000 tokens injected into prompt

Scan

Scan project and bootstrap memory with architecture and conventions

/cf-session
betaupdatedLow< 1,500 tokens injected into prompt

Session

Save current session to docs/sessions/ to resume on another machine

/cf-ship
updatedLow< 1,500 tokens injected into prompt

Ship

Verify, commit, push, and create PR in one command (supports --dry-run)

/cf-teach
updatedMedium1,500 – 3,000 tokens injected into prompt

Teach

Personal teacher — conversational storytelling breakdown of any task

/cf-warm
betaupdatedMedium1,500 – 3,000 tokens injected into prompt

Warm

Catch up after absence — summarize git history for a specific user

Auto-invoked skills

These skills activate automatically when relevant. No slash needed.

cf-sys-debug
updatedHigh> 3,000 tokens injected into prompt

Systematic Debug

4-phase debugging methodology for systematic problem solving

cf-tdd
updatedMedium1,500 – 3,000 tokens injected into prompt

Implementation Workflow

Direct implementation by default. Add --add-tests for TDD: RED, GREEN, REFACTOR

cf-verification
updatedLow< 1,500 tokens injected into prompt

Verification Gate

Ensures tests pass before claiming work is done

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.

Specialized agents

Skills dispatch work to focused agents, each optimized with the right model for their task.

cf-reviewer
Medium1,500 – 3,000 tokens injected into prompt

Reviewer

Review orchestrator: dispatches 5 specialist agents (plan, security, quality, tests, rules) in parallel + reducer.

/cf-review/cf-ship
inherit
cf-explorer
Low< 1,500 tokens injected into prompt

Explorer

Maps project structure, searches files, reads code, and writes structured context files for downstream agents.

/cf-plan/cf-ask/cf-fix
Haiku
cf-implementer
Low< 1,500 tokens injected into prompt

Implementer

Direct implementation by default; TDD with --add-tests. Isolated context, structured handoff, auto-retry on failure.

/cf-plan/cf-fix/cf-optimizecf-tdd
Sonnet
cf-planner
Medium1,500 – 3,000 tokens injected into prompt

Planner

Designs 2-3 implementation approaches with pros, cons, effort, risk, and a recommended path.

/cf-plan
Opus
cf-writer
Low< 1,500 tokens injected into prompt

Writer

Lightweight doc generation for memory files, notes, and straightforward markdown content.

/cf-learn/cf-remember/cf-scan/cf-ask
Haiku
cf-writer-deep
Low< 1,500 tokens injected into prompt

Writer Deep

Deep reasoning writer for nuanced technical content, complex trade-off analysis, and architecture docs.

/cf-learn
Sonnet

Get started in 4 steps

Install once, use in every project. More details in the documentation.

1Install CLI
npm i -g coding-friend-cli
2Install Plugin for Claude
cf install
3Initialize Workspace
cf init
4Update to the latest version
cf update