https://github.com/nxrobins/dotscope

The operating system for agent-driven codebases. Compiled retrieval, cross-language contracts, swarm coordination, AST-aware merging.
https://github.com/nxrobins/dotscope

agentic-engineering ai-agents code-intelligence context-engine developer-tools mcp

Last synced: 6 days ago
JSON representation

The operating system for agent-driven codebases. Compiled retrieval, cross-language contracts, swarm coordination, AST-aware merging.

• Host: GitHub
• URL: https://github.com/nxrobins/dotscope
• Owner: nxrobins
• License: mit
• Created: 2026-03-25T04:17:33.000Z (17 days ago)
• Default Branch: main
• Last Pushed: 2026-04-03T03:52:39.000Z (8 days ago)
• Last Synced: 2026-04-03T12:35:38.151Z (8 days ago)
• Topics: agentic-engineering, ai-agents, code-intelligence, context-engine, developer-tools, mcp
• Language: Python
• Homepage:
• Size: 2.37 MB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  



Your agent writes code that compiles, passes tests, and breaks production.

It changed a backend endpoint without touching the frontend that calls it.

It put a file in `src/helpers/` instead of next to the module that uses it.

It ignored the convention every other file follows. Two agents working at

the same time silently overwrote each other.

The agent sees files. You see architecture. dotscope closes that gap.

```

$ dotscope ingest

  Analyzing dependency graph...

  Mining git history...

  Discovering conventions...

  Discoveries:

  - version.py and environment.prod.ts always change together

  - workflow-edit-dialog.component.ts and models.py are tightly coupled

  Validation (49 commits backtested):

  - Overall recall: 78%

  - Token reduction: 67% (1.3M → 437K avg)

  Output: 3 .scope files written.

```

One MCP tool call. The agent gets the relevant code, its dependency

neighborhood, implicit contracts from git history, convention rules,

swarm lock status, and action hints. One call, not five.

dotscope learns from every commit. Files agents consistently need get

ranked higher. Conventions that hold get enforced harder. Rules that

get overridden get quieter. Recall starts at 78% and climbs past 91%.

```

pip install dotscope && dotscope init

```

Zero dependencies. Python 3.9+ stdlib only. MIT.

[How It Works](docs/how-it-works.md) · [Scope Files](docs/scope-file.md) · [Agent Instructions](AGENT_INSTRUCTIONS.md) · [MIT](LICENSE)