You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Dec 17, 2025. It is now read-only.
description: A CLI tool for managing and validating codebase context specifications, helping developers implement the CCS standard effectively.
4
+
description: MCP Server and a CLI tool for managing and validating dotcontext (.context) directories.
5
5
technologies:
6
+
- MCP Server
6
7
- Node.js
7
8
- TypeScript
8
9
- Commander.js
@@ -12,10 +13,11 @@ conventions:
12
13
- Implement semantic versioning
13
14
- Write unit tests for all features
14
15
architecture:
15
-
style: CLI Application
16
+
style: IDE Utilities via npx/npm
16
17
components:
18
+
- Content Collector - helps build a prompt from unstructured data in main module and submodules (core prompt generation functionality)
19
+
- Context Generator - supports the init commands and generates a starter template (analagous to git init)
17
20
- Context Validator
18
-
- Context Generator
19
21
- Context Linter
20
22
development:
21
23
setup-steps:
@@ -37,9 +39,9 @@ permissions:
37
39
allow-ai-modifications: true
38
40
---
39
41
40
-
# Codebase Context CLI
42
+
# Codebase Context MCP & CLI
41
43
42
-
A command-line interface tool for managing and validating codebase context specifications. This tool helps developers implement the Codebase Context Specification (CCS) effectively by providing utilities for creation, validation, and maintenance of `.context` directories.
44
+
A command-line interface tool for managing and validating codebase context specifications. This tool helps developers implement the Codebase Context Specification (CCS) effectively by providing utilities for creation, validation, and maintenance of `.context` directories. It also provides your tools with an MCP server that lets them pull in the .context into your context window. T
43
45
44
46
## Key Features
45
47
@@ -50,29 +52,13 @@ A command-line interface tool for managing and validating codebase context speci
50
52
51
53
## Project Goals
52
54
53
-
1. Replace and enhance the functionality of the existing `codebase-context-lint` package
54
-
2. Provide a more user-friendly CLI interface for managing context files
55
-
3. Help standardize the implementation of the CCS across projects
56
-
4. Facilitate better documentation practices in development teams
55
+
1. Help save / use summaries and descriptions for your coding agent relevant to your repositories
56
+
2. Help standardize the implementation of the CCS across projects letting AI understand across repositories
57
+
3. Facilitate better documentation practices in development teams
57
58
58
59
## Architecture
59
60
60
-
The tool is built as a Node.js CLI application using TypeScript and Commander.js. It follows a modular architecture with distinct components for different functionalities:
61
-
62
-
-**Context Validator**: Ensures `.context` directories comply with the CCS
63
-
-**Context Generator**: Creates new context files and directories
64
-
-**Context Linter**: Checks for best practices and potential improvements
61
+
Supports basic functions through CLI and MCP interfaces.
65
62
66
63
See the [architecture diagram](diagrams/architecture.mmd) for a visual representation of how the MCP server exposes tools that interact with the core components. The Context Manager acts as a central coordinator, leveraging the Validator and Linter as needed.
67
64
68
-
## Development Roadmap
69
-
70
-
1. Initial CLI setup with basic commands
71
-
2. Implementation of context validation
72
-
3. Context generation utilities
73
-
4. Advanced linting features
74
-
5. Integration with popular IDEs and tools
75
-
76
-
## Contributing
77
-
78
-
Contributions are welcome! Please ensure you follow our contribution guidelines and maintain test coverage for new features.
0 commit comments