COA Goldfish MCP is a crash-safe developer's work journal that captures, stores, and helps recall your coding session progress across projects.
Core Features:
Create Checkpoints: Save progress with descriptions, context, files, and git branch info for crash-safe development
Restore Sessions: Resume work after crashes or breaks with minimal or full restoration options
Search History: Use fuzzy search and natural language queries to find past work across checkpoints, memories, and workspaces
View Timeline: Get chronological work session overviews organized by date and workspace for standups or reviews
Summarize Sessions: Generate AI-condensed summaries of recent work or specific sessions
Manage TODOs: Create, view, and update task lists with statuses and priorities tied to your current session
Store Quick Notes: Remember temporary thoughts or reminders with optional tags and auto-expiration
Cross-Project Support: Work across multiple workspaces with smart normalization and integration with other MCP tools like ProjectKnowledge and CodeSearch
Designed for seamless integration with AI coding assistants to enable proactive checkpointing and context restoration.
Automatically captures git commits through hooks system to preserve development context and create memory checkpoints when code changes are committed.
COA Goldfish MCP (.NET)
Your development session's "flight recorder" - now with SQLite persistence and behavioral enforcement
π What is Goldfish (.NET)?
Goldfish .NET is a crash-safe developer's work journal rebuilt from the ground up with:
SQLite Database - Fast, reliable persistence with Entity Framework Core
Behavioral Enforcement - AI agents guided to use tools correctly and consistently
Streamlined Architecture - 7 unified tools that work as a cohesive system
Global Workspace Support - Cross-project TODOs and plans
Optional API Sync - Enterprise-ready with offline-first design
10x Performance - Faster data correlations and queries
π Installation
Method 1: Global .NET Tool (Recommended)
Method 2: Local Development
π Core Tools (Streamlined Architecture)
Unified Smart Tools
Goldfish .NET provides 7 main tools that enforce a cohesive workflow:
1. mcp__goldfish__plan
- Strategic Planning with Discovery Accumulation
Design features and create implementation roadmaps
Track discoveries and lessons learned during development
Generate TODO lists automatically from plans
Active Plan Concept - ONE active plan per workspace at a time
2. mcp__goldfish__todo
- Smart Task Management
Create and manage persistent TODO lists
Active List Concept - ONE active TODO list per workspace
Smart keyword resolution:
"latest"
,"active"
,"current"
Automatic cleanup of completed/stale tasks
3. mcp__goldfish__checkpoint
- Session State Management
Save/restore complete work context with workspace detection
Automatic file tracking, git branch capture, session correlation
Behavioral Enforcement - AI agents guided to checkpoint regularly
4. mcp__goldfish__standup
- Cross-Tool Progress Summaries
Daily/weekly/project summaries across all workspaces
Enhanced Reporting - Correlates data from checkpoints, TODOs, plans
Timeline integration for comprehensive progress tracking
5. mcp__goldfish__recall
- Context Restoration
Quick access to recent memories and work context
Cross-tool search for finding past decisions and solutions
No parameters needed - just instant context restoration
6. mcp__goldfish__chronicle
- Decision and Progress Tracking
NEW - Replaces standalone Intel tool with integrated decision tracking
Auto-populated from other tools or manual entry creation
Chronological progress logging for audit trails
7. mcp__goldfish__workspace
- Active Work State Management
NEW - Manages active plan and TODO list per workspace
Enforces the "ONE active item" concept for focused work
Cleanup orphaned work and validate workspace state
π― Key Improvements Over TypeScript Version
Behavioral Enforcement System
AI Agent Guidance - Tools work together as a system, not isolated commands
Active Work State - Enforces ONE active plan and TODO list per workspace
Automatic State Management - Prevents stale/orphaned work items
Workflow Validation - Ensures proper tool usage patterns
Performance & Architecture
SQLite + Entity Framework Core - 10x faster than JSON file operations
Structured Queries - Complex data correlations and cross-tool summaries
Transaction Safety - ACID compliance for data integrity
Automatic Migrations - Schema updates handled seamlessly
Enterprise Features
Optional API Sync - Sync data across teams/devices with offline-first design
Global Workspace - Cross-project TODO lists and plans using
__global__
workspaceAudit Trails - Complete history via Chronicle entries
Backup & Recovery - Built-in database backup during migrations
π Database Schema
Core Entities
π§ Configuration
Database Location
API Sync (Optional)
Behavioral Enforcement Levels
π Usage Examples
Morning Workflow
Strategic Planning
Cross-Workspace Reporting
Decision Tracking
π§ͺ Development & Testing
π¦ Migration from TypeScript Version
If you have existing TypeScript Goldfish data:
Note: Migration preserves all checkpoints, TODO lists, and plans while converting them to the new SQLite schema.
π― Behavioral Philosophy
Active Work Concept
ONE active plan per workspace - Enforces focused strategic work
ONE active TODO list per workspace - Prevents task fragmentation
Automatic cleanup - Stale work items are automatically archived
AI agent guidance - Built-in templates encourage proper usage patterns
Tool Priorities for AI Agents
Plan (90) - Strategic thinking first
Todo (95) - Task management
Checkpoint (100) - Session persistence
Standup (85) - Progress reporting
Recall (80) - Context restoration
Chronicle (75) - Decision tracking
Workspace (70) - State management
π Architecture Overview
π Deployment
Global Tool Package
Container Deployment (API Sync Server)
π License
MIT License - Build amazing workflows with structured persistence!
Ready to upgrade? The .NET version provides everything the TypeScript version offered, plus enterprise features, better performance, and AI agent behavioral enforcement for more productive development sessions.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A lightweight short-term memory MCP server that automatically stores and recalls working context, session state, and task progress for AI agents. Memories auto-expire after 24 hours and integrate seamlessly with workspace-aware storage across multiple projects.
- π What is Goldfish (.NET)?
- π Installation
- π Core Tools (Streamlined Architecture)
- π― Key Improvements Over TypeScript Version
- π Database Schema
- π§ Configuration
- π Usage Examples
- π§ͺ Development & Testing
- π¦ Migration from TypeScript Version
- π― Behavioral Philosophy
- π Architecture Overview
- π Deployment
- π License
Related MCP Servers
- -securityAlicense-qualityAn MCP server that extends AI agents' context window by providing tools to store, retrieve, and search memories, allowing agents to maintain history and context across long interactions.Last updated -9MIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server that provides persistent memory and context management for AI systems through a structured 5-phase optimization workflow.Last updated -1MIT License
- -securityFlicense-qualityA Model Context Protocol (MCP) server that provides persistent memory capabilities using OpenAI's vector stores, allowing AI assistants to save and search through memories across conversations.Last updated -2
- -securityAlicense-qualityAn enhanced MCP server that provides intelligent memory and task management for AI assistants, featuring semantic search, automatic task extraction, and knowledge graphs to help manage development workflows.Last updated -17MIT License