agent-vc-mcp

A specialized MCP server for AI agents to have persistent state, version control, and task management using Fossil SCM.

• Persistent State: Agents can store files in a structured, versioned workspace.
• Reproducibility: Full history of every commit, allowing rollbacks to any state.
• Task Management: Built-in tickets/tasks (via Fossil's ticket system) to track progress without external dependencies.
• Sandboxed: Operations are strictly limited to ~/.agent-vc/workspace/.

• ~/.agent-vc/: The root directory for all Agent-VC data and configuration.
• ~/.agent-vc/version_control.fossil: The Fossil repository file. This is a single SQLite database that stores your entire project history, version control objects, and task/ticket data.
• ~/.agent-vc/workspace/: The active checkout directory. All operations performed by the agent occur within this directory. This is the only place files are read from or written to.

Agent-VC uses a "Project" based organization within the shared workspace. This allows the agent to manage multiple logical projects or modules within a single version-controlled repository.

| Concept | Description | Path Example | | :--- | :--- | :--- | | Workspace Root | The base directory for all operations. | ~/.agent-vc/workspace/ | | Project Folder | A subdirectory representing a specific project. | ~/.agent-vc/workspace/chatbot-v1/ | | Project Subpath | A file or nested folder within a project. | ~/.agent-vc/workspace/chatbot-v1/src/utils.js |

When using the agent-vc tools, you interact with files using the project and subPath parameters. This abstraction maps directly to the filesystem:

1. Initializing a Project: Running `vc_init_proj