{"id":47234105,"url":"https://github.com/whaleen/cntx-ui","last_synced_at":"2026-03-13T21:37:22.433Z","repository":{"id":294785981,"uuid":"988031676","full_name":"whaleen/cntx-ui","owner":"whaleen","description":"File context management tool with web UI and MCP server for AI development workflows - bundle project files for LLM consumption","archived":false,"fork":false,"pushed_at":"2026-02-28T09:54:59.000Z","size":34761,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-28T10:17:12.755Z","etag":null,"topics":["ai","ai-development","ai-workflow","bundling","claude-desktop","cli-tool","codebase","codebase-bundling","context-management","development-tools","file-aggregation","file-bundling","file-management","llm-tools","mcp-server","model-context-protocol","project-context","react","websocket"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/cntx-ui","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whaleen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-22T00:37:30.000Z","updated_at":"2026-02-28T09:55:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"805038b6-971a-439a-95d3-8bf192d9eec3","html_url":"https://github.com/whaleen/cntx-ui","commit_stats":null,"previous_names":["nothingdao/cntx","whaleen/cntx-ui"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/whaleen/cntx-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleen%2Fcntx-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleen%2Fcntx-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleen%2Fcntx-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleen%2Fcntx-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whaleen","download_url":"https://codeload.github.com/whaleen/cntx-ui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleen%2Fcntx-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30476457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T20:45:58.186Z","status":"ssl_error","status_checked_at":"2026-03-13T20:45:20.133Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-development","ai-workflow","bundling","claude-desktop","cli-tool","codebase","codebase-bundling","context-management","development-tools","file-aggregation","file-bundling","file-management","llm-tools","mcp-server","model-context-protocol","project-context","react","websocket"],"created_at":"2026-03-13T21:37:20.608Z","updated_at":"2026-03-13T21:37:22.420Z","avatar_url":"https://github.com/whaleen.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cntx-ui\n\nSemantic code analysis and context management for AI agents. Turns a codebase into searchable, structured context that agents can navigate efficiently.\n\n## What it does\n\n- **Semantic analysis** — parses your code at the function level using tree-sitter, extracts purpose, complexity, and relationships\n- **Local vector search** — embeds code chunks locally (all-MiniLM-L6-v2 via Transformers.js) for semantic similarity search with no external API calls\n- **Bundle system** — group files into logical bundles (by feature, layer, or pattern) for structured context delivery\n- **MCP server** — exposes 28+ tools to Claude Code, Claude Desktop, or any MCP-compatible client\n- **Web dashboard** — visual interface at localhost:3333 for managing bundles, browsing semantic analysis, and editing agent rules\n- **Real-time sync** — watches for file changes and keeps analysis, bundles, and embeddings current\n\n## Install\n\n```bash\nnpm install -g cntx-ui\n```\n\n## Usage\n\n```bash\ncntx-ui init          # scaffold .cntx directory, generate .mcp.json\ncntx-ui watch         # start web server on port 3333\ncntx-ui mcp           # start MCP server on stdio\ncntx-ui bundle \u003cname\u003e # regenerate a specific bundle\ncntx-ui status        # show project health and bundle state\ncntx-ui setup-mcp     # configure Claude Desktop integration\n```\n\nAfter `cntx-ui init`, agents discover tools automatically via `.mcp.json`. The `.cntx/AGENT.md` file provides an onboarding handshake with tool reference and project overview.\n\n## Agent interface\n\nAgents interact through MCP tools or the HTTP API:\n\n| MCP Tool | What it does |\n| :--- | :--- |\n| `agent/discover` | Architectural overview of the codebase |\n| `agent/query` | Semantic search — \"where is auth handled?\" |\n| `agent/investigate` | Find integration points for a new feature |\n| `agent/organize` | Audit and optimize bundle structure |\n| `artifacts/list` | List normalized project artifacts (OpenAPI + Navigation) |\n| `artifacts/get_openapi` | Return OpenAPI artifact summary and payload |\n| `artifacts/get_navigation` | Return Navigation artifact summary and payload |\n| `artifacts/summarize` | Compact cross-artifact summary for agents |\n| `list_bundles` | List all bundles with metadata |\n| `get_bundle` | Get full bundle content as XML |\n| `get_semantic_chunks` | Get all analyzed code chunks |\n| `read_file` / `write_file` | File operations with bundle context |\n\nFull tool reference with parameters is generated in `.cntx/AGENT.md` and `.cntx/TOOLS.md`.\n\nArtifact HTTP endpoints:\n- `GET /api/artifacts`\n- `GET /api/artifacts/openapi`\n- `GET /api/artifacts/navigation`\n\n## How it works\n\n1. **tree-sitter** parses source files into AST, extracts functions/types/interfaces\n2. **Heuristics engine** classifies each chunk by purpose, business domain, and technical patterns based on file paths, imports, and naming conventions\n3. **Embeddings** are generated locally and stored in SQLite for persistent vector search\n4. **Bundles** group files by glob patterns — auto-suggested on init based on project structure\n5. **MCP server** and **HTTP API** expose everything to agents with consistent response shapes\n\n## Tech stack\n\n- Node.js, better-sqlite3, ws (WebSocket)\n- tree-sitter (AST parsing), Transformers.js (local embeddings)\n- React 19, TypeScript, Vite, Tailwind CSS (web dashboard)\n- Model Context Protocol (MCP) via JSON-RPC 2.0\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhaleen%2Fcntx-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhaleen%2Fcntx-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhaleen%2Fcntx-ui/lists"}