{"_id":"10x-code","_rev":"3-d7e9ffcea3d9b33a3d45be56daa5ce9b","name":"10x-code","dist-tags":{"latest":"2.0.2"},"versions":{"2.0.0":{"name":"10x-code","version":"2.0.0","keywords":["claude-code","context-engineering","codebase-indexing","token-optimization","dependency-graph","symbol-search","programming-first","zero-token","agent-skill","mcp","ai-coding","claude","anthropic"],"author":{"url":"https://10x.in","name":"10x.in"},"license":"MIT","_id":"10x-code@2.0.0","maintainers":[{"name":"thinqmesh","email":"getintouch.anit@gmail.com"}],"homepage":"https://10x.in","bugs":{"url":"https://github.com/AnitChaudhry/10x-Code/issues"},"bin":{"ccs":"dist/cli.js","10x-code":"bin/cli.js","ccs-install":"bin/cli.js"},"dist":{"shasum":"3ae947a0c39ff39e38bc102d7f4649b6976aa272","tarball":"https://registry.npmjs.org/10x-code/-/10x-code-2.0.0.tgz","fileCount":128,"integrity":"sha512-xQ6r9q2NGmR4TFDZ6Fo+kYHJEM454G2YhGp8FQwiRI3FITtPTPQZ3eWrRtdaoSSKXBJ7ODn94kTlDdI+UGUCxg==","signatures":[{"sig":"MEQCIDCjwj1jii+oj4/LD13ylQ4ueucv4fPWxhioDzeqyLpHAiAxRP5OWxTEC+biS5JD/UrWQfA9uYMwtUCvAkTSskabNA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":472726},"engines":{"node":">=16"},"scripts":{"build":"tsc","build:watch":"tsc --watch","postinstall":"node bin/cli.js init 2>/dev/null || true","prepublishOnly":"npm run build"},"_npmUser":{"name":"thinqmesh","email":"getintouch.anit@gmail.com"},"repository":{"url":"git+https://github.com/AnitChaudhry/10x-Code.git","type":"git"},"_npmVersion":"10.9.2","description":"Programming-first context engine for Claude Code — TypeScript-powered codebase indexing, dependency graphing, symbol-level search, and zero-token context injection via hooks.","directories":{},"_nodeVersion":"22.14.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/10x-code_2.0.0_1772794312274_0.7287946411036703","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"10x-code","version":"2.0.2","keywords":["claude-code","context-engineering","codebase-indexing","token-optimization","dependency-graph","symbol-search","programming-first","zero-token","agent-skill","mcp","ai-coding","claude","anthropic"],"author":{"url":"https://10x.in","name":"10x.in"},"license":"SEE LICENSE IN LICENSE","_id":"10x-code@2.0.2","maintainers":[{"name":"thinqmesh","email":"getintouch.anit@gmail.com"}],"homepage":"https://10x.in","bugs":{"url":"https://github.com/10x-Anit/10x-Code-Context/issues"},"bin":{"ccs":"dist/cli.js","10x-code":"bin/cli.js","ccs-install":"bin/cli.js"},"dist":{"shasum":"443b32385a5ad26ed97b7d84abf7153858cdc12b","tarball":"https://registry.npmjs.org/10x-code/-/10x-code-2.0.2.tgz","fileCount":133,"integrity":"sha512-WVkNWnJTApTntZJSozLt+CgYLkwCcG4bGoa+qdrsrPRWLQoVm2/Wq9F4uSsD2LEGah+n8iOUaAFTsYvQJL3W/g==","signatures":[{"sig":"MEUCIC42aMhd+MMgJkS2nD+e6YCVkQSrxNcvk4tdCd5VvSPAAiEA58XgWIZJfMxNR0RB6pqv/5jpOonXLbesHijpHQMTo8k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":493498},"engines":{"node":">=16"},"gitHead":"0a7a2ec1035af2ec32190479fd7385fe5ac8409f","scripts":{"build":"tsc","build:watch":"tsc --watch","postinstall":"node bin/cli.js init || echo '\\n⚠ 10x-Code postinstall failed. Run manually: npx 10x-code init\\n'","prepublishOnly":"npm run build"},"_npmUser":{"name":"thinqmesh","email":"getintouch.anit@gmail.com"},"repository":{"url":"git+https://github.com/10x-Anit/10x-Code-Context.git","type":"git"},"_npmVersion":"10.9.2","description":"Programming-first context engine for Claude Code — TypeScript-powered codebase indexing, dependency graphing, symbol-level search, and zero-token context injection via hooks.","directories":{},"_nodeVersion":"22.14.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/10x-code_2.0.2_1773215053399_0.7446597075535148","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-03-06T10:51:52.273Z","modified":"2026-04-25T18:40:31.276Z","2.0.0":"2026-03-06T10:51:52.427Z","2.0.2":"2026-03-11T07:44:13.571Z"},"bugs":{"url":"https://github.com/10x-Anit/10x-Code-Context/issues"},"author":{"url":"https://10x.in","name":"10x.in"},"license":"SEE LICENSE IN LICENSE","homepage":"https://10x.in","keywords":["claude-code","context-engineering","codebase-indexing","token-optimization","dependency-graph","symbol-search","programming-first","zero-token","agent-skill","mcp","ai-coding","claude","anthropic"],"repository":{"url":"git+https://github.com/10x-Anit/10x-Code-Context.git","type":"git"},"description":"Programming-first context engine for Claude Code — TypeScript-powered codebase indexing, dependency graphing, symbol-level search, and zero-token context injection via hooks.","maintainers":[{"email":"getintouch.anit@gmail.com","name":"thinqmesh-tech"}],"readme":"<p align=\"center\">\n  <img src=\"https://10x.in/logo.png\" alt=\"10x.in\" width=\"120\" />\n</p>\n\n<h1 align=\"center\">10x-Code</h1>\n\n<p align=\"center\">\n  <strong>Context Engineering Middleware for Claude Code</strong><br/>\n  Intelligent codebase indexing, token-efficient file selection, and session persistence — all via local MD files\n</p>\n\n<p align=\"center\">\n  <a href=\"https://10x.in\">Website</a> &middot;\n  <a href=\"#installation\">Install</a> &middot;\n  <a href=\"#slash-commands\">Commands</a> &middot;\n  <a href=\"#how-it-works\">How It Works</a> &middot;\n  <a href=\"#agents\">Agents</a>\n</p>\n\n---\n\n> **Proprietary Software of [10x.in](https://10x.in)** — Designed, developed, and maintained by the **10x Team**. This plugin is the intellectual property of 10x.in. All rights reserved.\n\n---\n\n## What is 10x-Code?\n\n**10x-Code** is a production-grade context engineering middleware built by the **10x Team** that sits between your queries and Claude Code. It ensures every interaction has precisely the right context — no wasted tokens exploring irrelevant files, no losing track of what changed.\n\n**Before 10x-Code:** Claude Code explores your codebase from scratch on every query, reading files it doesn't need, losing context when the window fills up.\n\n**With 10x-Code:** Your codebase is indexed once, only relevant files are read per query, and everything is tracked in local MD files that persist across sessions.\n\n### Key Highlights\n\n- **23 slash commands** across 6 categories — context, workflow, testing, research, git, operations\n- **6 specialist agents** — context builder, test runner, code auditor, git tracker, knowledge guide, team lead\n- **Dependency-aware indexing** — files ranked by import centrality, not just name matching\n- **Zero-token context injection** — Glob + Grep lookups cost no API tokens\n- **Session persistence** — commit-style task logging in local MD files\n- **Hook system** — automated lifecycle hooks for session management and path protection\n- **MCP server integration** — remote tools endpoint at `10x.in/api/mcp`\n- **Cross-model optimized** — Haiku for scanning, Sonnet for coding, Opus for reasoning\n\n## Installation\n\n### npx (recommended)\n\n```bash\nnpx 10x-code init\n```\n\n### bun\n\n```bash\nbunx 10x-code init\n```\n\n### Global install\n\n```bash\nnpm install -g 10x-code\nccs init\n```\n\n### Manual\n\n```bash\ngit clone https://github.com/10x-Anit/10x-Code-Context.git\n# Copy each skill as its own directory (Claude Code requires one level deep)\nfor d in 10x-Code-Context/skills/*/; do\n  name=$(basename \"$d\")\n  cp -r \"$d\" \".claude/skills/ccs-$name/\"\ndone\n# Copy shared resources\ncp -r 10x-Code-Context/{agents,templates,references} .claude/skills/_ccs/\n# Copy MCP config\ncp 10x-Code-Context/.mcp.json .mcp.json\n```\n\n> **Important:** Skills must be at `.claude/skills/<name>/SKILL.md` (one level deep). Do NOT nest deeper — Claude Code won't discover them.\n\n## Slash Commands\n\n### Context Management\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-init` | Deep-research the codebase, generate project-map, architecture, file-index, conventions |\n| `/ccs-status` | Show what's indexed, staleness, file counts, token savings estimate |\n| `/ccs-refresh` | Rebuild index (full, incremental, or session-based) |\n| `/ccs-query [question]` | Preview which files would be selected for a given query |\n\n### Workflow\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-plan [task]` | Plan a task with full dependency-aware context |\n| `/ccs-build [task]` | Create/implement with tracked context and commit-style logging |\n| `/ccs-refactor [scope]` | Scope a refactor — identify all affected files and dependencies |\n| `/ccs-fix [issue]` | Fix bugs with dependency tracking, root-cause analysis, and verification |\n| `/ccs-team [task]` | Spawn an agent team for complex multi-part tasks |\n\n### Testing & Quality\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-test [scope]` | Run tests, track results locally, suggest and auto-fix failures |\n| `/ccs-audit [scope]` | Audit code for security, performance, patterns, accessibility, dead code |\n| `/ccs-review [scope]` | Code review with full context — style, logic, security, performance |\n\n### Research & Docs\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-research [query]` | Search official docs, resolve errors, check deps, find best practices |\n\n### Setup\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-connect` | Set up MCP server — creates/updates .mcp.json, verifies connection |\n\n### Git Workflow\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-branch` | Create/switch branches with auto-generated context reference files |\n| `/ccs-pr` | Prepare PR with full context — title, summary, blast radius, review areas |\n| `/ccs-merge` | Merge with dependency checking — conflict prediction, resolution context |\n| `/ccs-diff` | Smart diff with impact analysis — dependency chains, blast radius |\n| `/ccs-sync` | Pull/rebase/push with conflict context and resolution recommendations |\n| `/ccs-stash` | Stash with tracked context — remembers what you were working on |\n| `/ccs-log` | Smart commit history — groups by branch, cross-references with task.md |\n\n### Operations\n\n| Command | Description |\n|---------|-------------|\n| `/ccs-deploy` | Pre-deployment checklist — tests, build, env vars, deps, breaking changes |\n| `/ccs-track` | View/manage session task log, see all changes made this session |\n\n## How It Works\n\n### 1. Initialization (`/ccs-init`)\n\nScans your entire codebase and generates local reference files in `.ccs/`:\n\n- **project-map.md** — File tree + dependency graph (imports/exports/references)\n- **architecture.md** — Tech stack, patterns, entry points, data flow\n- **file-index.md** — Files ranked by importance (most-imported = highest rank)\n- **conventions.md** — Coding style, naming patterns, test patterns\n\n### 2. Per-Query Context (automatic)\n\nWhen you ask Claude Code anything, the skill:\n1. Looks up the pre-built index for matching files/symbols\n2. Runs targeted Glob + Grep (zero API cost) to find candidates\n3. Follows import/dependency chains of matched files\n4. Claude Code reads ONLY the files that matter\n\n### 3. Session Tracking\n\nEvery action is logged in `.ccs/task.md` with git-commit-style entries:\n- Task description, files read/modified/created/deleted\n- Dependencies identified, status, diff summary\n- Persists context without consuming API tokens\n\n## Agents\n\n| Agent | Role |\n|-------|------|\n| **Context Builder** | Deep codebase analysis, generates `.ccs/` index files |\n| **Test Runner** | Runs tests, tracks results, auto-fixes failures |\n| **Code Auditor** | Security, performance, dead code, accessibility audits |\n| **Git Tracker** | Git workflow — branches, PRs, merges, diffs, sync |\n| **Knowledge Guide** | Proactive methodology guidance, note quality, connection suggestions |\n| **Team Lead** | Multi-agent team coordination, task decomposition, parallel dispatch |\n\n## Model Strategy\n\n| Model | Used For | Commands |\n|-------|----------|----------|\n| **Haiku 4.5** | Lightweight lookups, scanning, status checks | status, refresh, query, track, stash, log |\n| **Sonnet 4.6** | Standard coding execution | build, fix, test, branch, sync |\n| **Opus 4.6** | Deep reasoning, architecture, complex analysis | init, plan, refactor, audit, review, research, deploy, pr, merge, diff, team |\n\n## MCP Server Connection\n\nThe plugin ships with a `.mcp.json` that configures the CCS remote MCP server automatically:\n\n```json\n{\n  \"mcpServers\": {\n    \"ccs\": {\n      \"type\": \"http\",\n      \"url\": \"https://10x.in/api/mcp\"\n    }\n  }\n}\n```\n\nThis provides 6 MCP tools: skill info, all 23 command docs, OS-specific install commands, model strategy, and context file details. Run `/ccs-connect` to configure or verify.\n\n## Hooks System\n\nAutomated lifecycle hooks for session management. **All hooks are Node.js** — fully cross-platform (Windows, Mac, Linux), zero bash dependency.\n\n| Hook | Trigger | What It Does |\n|------|---------|-------------|\n| `path-guard.js` | PreToolUse | Blocks writes to immutable paths, warns on guarded paths |\n| `session-orient.js` | SessionStart | Injects workspace tree, goals, conditions, maintenance signals |\n| `session-summary.js` | SessionStart | Injects compact project summary for prompt cache hits |\n| `context-inject.js` | UserPromptSubmit | Injects relevant context on every query via CCS engine |\n| `index-update.js` | PostToolUse | Incrementally updates index after file writes/edits |\n| `write-validate.js` | PostToolUse | Validates YAML frontmatter on note files |\n| `auto-commit.js` | PostToolUse | Auto-commits changes to git after writes |\n| `session-capture.js` | Stop | Saves session state, commits artifacts |\n\nHooks are automatically registered in `~/.claude/settings.json` during installation with absolute `node` paths — no PATH dependency.\n\n## Generated Files\n\nAll context files are stored in `.ccs/` (add to `.gitignore`):\n\n```\n.ccs/\n├── project-map.md      # File structure + dependency graph\n├── architecture.md     # Tech stack, patterns, data flow\n├── file-index.md       # Files ranked by importance\n├── conventions.md      # Coding style and patterns\n├── task.md             # Session task log (commit-style)\n├── preferences.json    # User preferences (refresh mode, etc.)\n├── branches/<name>.md  # Per-branch reference files\n├── pulls/<name>.md     # PR documentation\n├── merge-history.md    # Append-only merge log\n├── commit-log.md       # Summarized commit history\n└── team-board.md       # Multi-agent team task board\n```\n\n## Project Structure\n\n```\n10x-Code/\n├── skills/             # 23 slash command definitions\n├── agents/             # 6 specialist subagent definitions\n├── references/         # Strategy docs, quality standards, feature docs\n├── templates/          # MD templates for generated files\n├── hooks/              # Claude Code lifecycle hooks\n├── src/                # TypeScript source\n├── dist/               # Compiled output\n├── bin/                # CLI entry points\n├── statusline/         # Statusline integration\n├── manifest.json       # Machine-readable skill/agent definitions\n├── SKILLS-TREE.md      # Master skill index\n├── AGENTS-INDEX.md     # Agent lookup reference\n├── CLAUDE.md           # Plugin orchestrator\n├── package.json        # v2.0.2\n└── LICENSE             # Proprietary\n```\n\n## Requirements\n\n- Node.js 16+\n- Claude Code (or compatible AI coding assistant)\n- Python 3.8+ (optional, for some analysis features)\n\n## License\n\n**Proprietary Software** — Copyright (c) 2025-2026 [10x.in](https://10x.in). All rights reserved.\n\nThis software is the exclusive intellectual property of 10x.in. No part of this software may be reproduced, distributed, modified, or transmitted without prior written permission from 10x.in.\n\nSee [LICENSE](LICENSE) for full terms. For licensing inquiries, contact the 10x Team at [10x.in](https://10x.in).\n\n---\n\n<p align=\"center\">\n  <sub>Built with precision by the <strong>10x Team</strong> at <a href=\"https://10x.in\">10x.in</a></sub><br/>\n  <sub>10x-Code v2.0.2</sub>\n</p>\n","readmeFilename":"README.md"}