Skip to main content

Agents see files. You see architecture. dotscope gives agents the architecture.

Project description

dotscope

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 · Scope Files · Agent Instructions · MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dotscope-1.3.0.tar.gz (2.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dotscope-1.3.0-py3-none-any.whl (299.6 kB view details)

Uploaded Python 3

File details

Details for the file dotscope-1.3.0.tar.gz.

File metadata

  • Download URL: dotscope-1.3.0.tar.gz
  • Upload date:
  • Size: 2.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dotscope-1.3.0.tar.gz
Algorithm Hash digest
SHA256 09446f58bbcca7a8187cab25e912fa493d57e2ac7088f0c90ca9953a728f0385
MD5 1723b775f6279561ffdcfda61f16a835
BLAKE2b-256 3cde3414329c049a010b9580a75b000bea5093eed41e6eba2280f8e13ebaf526

See more details on using hashes here.

Provenance

The following attestation bundles were made for dotscope-1.3.0.tar.gz:

Publisher: python-publish.yml on nxrobins/dotscope

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dotscope-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: dotscope-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 299.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dotscope-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 215279e2a5161ce44e8aac79dde7feba70a98dbe99afd2591acee4b7bcd0473f
MD5 ca0a6def2413f45324e71235529db774
BLAKE2b-256 92005d903f3766b245493fe20061104df53043e3f8c514b9c846549eae7dab7e

See more details on using hashes here.

Provenance

The following attestation bundles were made for dotscope-1.3.0-py3-none-any.whl:

Publisher: python-publish.yml on nxrobins/dotscope

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page