https://github.com/dinhanhthi/coding-friend
Lean toolkit for disciplined engineering workflows with Claude Code.
https://github.com/dinhanhthi/coding-friend
agent claude claude-code cli dinhanhthi mcp skills vibe-coding
Last synced: about 1 month ago
JSON representation
Lean toolkit for disciplined engineering workflows with Claude Code.
- Host: GitHub
- URL: https://github.com/dinhanhthi/coding-friend
- Owner: dinhanhthi
- Created: 2026-02-16T08:53:42.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T10:07:54.000Z (about 2 months ago)
- Last Synced: 2026-04-28T11:34:46.022Z (about 2 months ago)
- Topics: agent, claude, claude-code, cli, dinhanhthi, mcp, skills, vibe-coding
- Language: TypeScript
- Homepage: https://cf.dinhanhthi.com
- Size: 3.11 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Coding Friend
Lean toolkit for disciplined engineering workflows with Claude Code.
Website ·
Documentation ·
Changelog ·
Report Bug
## What It Does
- Supports test-driven development (TDD) — opt-in via `--add-tests` flag or `tdd: true` in config
- Provides systematic debugging methodology
- Quick bug fix workflow (`/cf-fix`)
- Structured optimization with before/after measurement (`/cf-optimize`)
- Quick Q&A about codebase with memory (`/cf-ask`)
- Ensures verification before claiming done
- Smart conventional commits and code review
- ✨ Cross-agent code review (`/cf-review-out` + `/cf-review-in`) — generate a review prompt for any AI agent (Gemini, Codex, ChatGPT, or human), collect results when ready
- Captures project knowledge across sessions (`/cf-remember`)
- ✨ Persistent AI memory with 3-tier hybrid search (`cf memory`) — stores facts, preferences, debug episodes across sessions with automatic recall
- ✨ Helps humans learn from vibe coding sessions (`/cf-learn` for concise notes, `/cf-teach` for deep conversational breakdowns) — browse as a searchable website (`cf host`) or share with other LLM clients via MCP server (`cf mcp`)
- In-depth research with web search and parallel subagents (`/cf-research`)
- Custom skill guides — extend built-in skills with your own Before/Rules/After per skill
- ✨ Save and load Claude Code session chats across machines and accounts (`/cf-session`)
- ✨ Smart auto-approve — 3-step hook (rules → working-dir check → Sonnet LLM classifier) auto-approves read-only tools and working-dir file edits, blocks destructive commands, and uses an LLM classifier for everything else. When blocked, Claude gets the reason and tries alternatives. Available to all users, opt-in via config
- Prompt injection defense — layered content isolation protects against malicious instructions
- CLI utilities — manage plugin installation, project setup, and updates with a single `cf` command. `cf permission` lets you interactively configure Claude Code's tool permissions
- ✨ Customizable Claude Code statusline with account info & API rate limit tracking
```
🧠 Opus (1M)
cf v0.3.0 | 📂 MyProject (⎇ main) | 👤 Thi Dinh (me@dinhanhthi.com)
ctx 42% | [5h] 30% → 2:30pm | [7d] 10% → mar 15, 2:30pm
📋 Tasks: 2/5 | 🤖 Agent: cf-reviewer
```
For full details, visit the **[official website](https://cf.dinhanhthi.com/#features)**.
## Quick Start
Requires [Node.js](https://nodejs.org/) 20+ and [Claude Code](https://claude.com/claude-code).
1. Install the CLI: `npm i -g coding-friend-cli`
2. Install the plugin: `cf install`
Or install manually (no CLI)
```bash
claude plugin marketplace add dinhanhthi/coding-friend
claude plugin install coding-friend@coding-friend-marketplace
```
3. Initialize your workspace: `cf init`
4. Restart Claude Code
5. **(Optional) Enable AI memory** — stores project knowledge across sessions with automatic recall:
```bash
cf memory start-daemon # Start daemon with fuzzy search (Tier 2)
cf memory init # Initialize SQLite with hybrid search (Tier 1)
cf memory status # Check current tier and document count
```
Then bootstrap memory inside Claude Code: `/cf-scan This is a Next.js app with PostgreSQL and Stripe`
Learn more: [cf memory](cli/README.md#cf-memory), [Memory System](https://cf.dinhanhthi.com/docs/reference/memory-system/).
6. **(Optional) Host your learning docs** — browse `/cf-learn` and `/cf-teach` notes as a website or expose to other LLM clients:
```bash
cf host # Serve docs/learn/ as a website at localhost:3333
cf mcp # Setup an MCP server so other LLM clients can read your notes
```
Learn more: [cf host](cli/lib/learn-host/README.md), [cf mcp](cli/lib/learn-mcp/README.md).
## Commands
| Command | Description |
| ----------------------------------------------- | -------------------------------------------------------------------------------- |
| `/cf-ask [question]` | Quick Q&A about codebase |
| `/cf-commit [hint]` | Analyze diff and create conventional commit |
| `/cf-design [mode]` | UI design: scan patterns, design or modify UI consistently |
| `/cf-fix [bug]` | Quick bug fix workflow |
| `/cf-help [question]` | Answer questions about Coding Friend |
| `/cf-learn [topic]` | Extract learnings for human review |
| `/cf-optimize [target]` | Structured optimization with measurement |
| `/cf-plan [task]` \| `/cf-plan --resume ` | Brainstorm and write implementation plan; `--resume` resumes an interrupted plan |
| `/cf-remember [topic]` | Capture project knowledge |
| `/cf-research [topic]` | In-depth research with web search |
| `/cf-review [target]` | Code review in forked subagent |
| `/cf-scan [desc]` | Scan project and bootstrap memory |
| `/cf-session` | Save/load Claude Code sessions |
| `/cf-ship [hint]` | Verify, commit, push, and create PR |
| `/cf-teach [topic]` | Personal teacher — conversational breakdown |
| `/cf-warm [--user]` | Catch up after absence — git history summary |
Auto-invoked skills (no slash needed): `cf-tdd`, `cf-sys-debug`, `cf-verification`.
## CLI Commands
The plugin is managed by the CLI `cf` command. Learn more about the CLI in the [CLI documentation](cli/README.md).
## Plugin development
For plugin developers, check [plugin-dev.md](docs/plugin-dev.md).
## Further Reading
Read the [official documentation](https://cf.dinhanhthi.com).
## License
MIT