Skip to main content

attocode-code-intel

Local code search and navigation for coding agents and for people. It runs as an MCP server for Codex, Claude Code, Cursor and other MCP clients, and as a command in your terminal. It needs no model, no API key and no network.

Status: beta. We measured the search quality (see What we measured). We have not shown that it makes agents faster or more accurate.

Quickstart

You need Python 3.12 or later and Git.

uv tool install attocode-code-intel
cd /path/to/your/project
attocode-code-intel init

Then restart your agent. init configures Codex, Claude Code and Cursor. Use --client claude, --client codex or --client cursor for one client. Codex needs a trusted project for a project configuration. Claude Code can ask you to enable the project MCP server.

To check the setup, run attocode-code-intel doctor. It starts the configured server, calls two tools and shows the result for each client. The probe also reports the executable and server version returned by that new probe. An already running client session must be checked separately.

For other clients (VS Code, Zed, Windsurf, Claude Desktop and more), run attocode-code-intel install <target>. attocode-code-intel commands lists the targets.

To run the server without an installation, use uvx. This is a configuration for any MCP client that starts a local command:

{
  "mcpServers": {
    "attocode-code-intel": {
      "command": "uvx",
      "args": ["attocode-code-intel", "--project", "/absolute/path/to/your/project"]
    }
  }
}

You can omit --project if the client sends one workspace root. Otherwise the server looks for a repository marker such as .git in the working folder and its parents, but never selects your home folder. If it finds no repository, it stops with an error.

To use the latest source, install from a clone of this repository: uv tool install /path/to/attocode/packages/code-intel.

What your agent gets

Version 0.1.35 adds an optional stdio-to-HTTP client bridge that manages a live cancellation context and forwards tool cancellation using the actual upstream SDK request ID. init --http-cancellation configures the bridge with a named token environment variable. Authentication and the server's cancellation opt-in are still required; notification enqueueing is best effort. See the release notes for setup, verification and transport limits.

Version 0.1.34 corrects gateway cancellation and workspace-worker ownership, and adds optional authenticated HTTP tool-call cancellation. HTTP cancellation stays off by default and requires a per-client UUID4 context and one server process or context affinity. See the release notes for setup, verification and remaining limits.

Version 0.1.33 makes remote-settings saves atomic and private, preserves old config bytes on failed writes, and refuses symlink redirects or invalid and oversized data. The existing Perl roots and TOML values survive successful saves. See the release notes for the Linux/macOS contract, refusal behavior and remaining limits.

Version 0.1.32 adds explicit Perl module roots in .attocode/config.toml, refreshes dependencies after config-only edits, and preserves valid TOML when saving remote settings. File-discovery exclusions and unresolved module ambiguity remain conservative. See the release notes.

Version 0.1.31 retains prior vectors during failed live refresh, fences superseded queued writes, and commits file vectors and metadata together. Go receiver identities agree across keyword, body and vector search; optional fusion keeps distinct source spans and preserves vector text when only keyword metadata is available. Future cache formats are refused before journal or permission changes. See the release notes for validation and bounds.

Version 0.1.30 preserves Java, C and Go signature metadata, Go type and receiver ownership, and imports inside declared Go standard modules. Parameter and body-only edits update cached metadata and callers, while startup checks parser and indexer identity before reusing persisted symbols. See the release notes for source-pinned validation and limits.

Version 0.1.29 recognizes Perl .t test scripts in both parser entry points, making native test imports and callers available when a Perl grammar is installed or cached. Source-pinned Carp checks cover real cross-file navigation and scoped inclusion through refresh/restart. See the release notes.

Version 0.1.28 summarizes duplicate compact-search metadata diagnostics after evidence fitting. Full lexical-index details remain at data.ranking.index, with readiness and coverage hints in metadata.ranking.index. Results and source excerpts are unchanged. See the release notes.

Version 0.1.27 fixes a dictionary-size error during symbol inspection when AST hydration changes the cache concurrently. Namespace resolution snapshots cached file membership; later changes appear in the next build. See the release notes.

Version 0.1.26 gives Rust precision lookups a shared five-second budget and fixes cancelled startup cleanup when a child retains inherited pipes. Other languages keep two seconds; longer reloads still return partial evidence.

Version 0.1.25 uses OpenAI embeddings only when you set ATTOCODE_EMBEDDING_MODEL=openai. Before, an OPENAI_API_KEY in the environment was enough to send code chunks to OpenAI at index time. Rust references are also more reliable while rust-analyzer loads.

Version 0.1.24 adds ATTOCODE_INTEL_RANKING_PROVIDER=openrouter, a preset for the opt-in hosted rerank. In a frozen trial with 24 short questions, the rerank found 24 of 26 labeled files in the first five results, against 20 without it; see Hosted rerank. Rerank stays off by default, because it sends source excerpts to OpenRouter.

Version 0.1.23 is listed in the official MCP Registry and documents a uvx quick start. The opt-in hosted rerank now accepts the dated model ID that OpenRouter returns; see Hosted rerank. Rerank stays off by default.

Version 0.1.22 adds an opt-in discovery budget of up to 100,000 files (ATTOCODE_INTEL_DISCOVERY_MAX_FILES; the default stays 50,000). It also packages the LLM client, so ATTOCODE_FLAG_CONFIDENCE=llm and LLM rule synthesis work from a PyPI install when an OpenRouter or Anthropic key is set.

Version 0.1.21 includes configured search-discovery coverage, OCaml interface parsing and more conservative Go/Rust fallback evidence. The existing 100 ms native budget and 50,000-file discovery safety ceiling remain; bounded fallback is heuristic.

Version 0.1.20 improves native OCaml/Perl call candidates and conservative workspace import candidates for OCaml, Perl and Crystal. Physical paths and ambiguity remain guarded; native limits, ranking and dependencies are unchanged. Optional grammars must be explicitly available before analysis; navigation never downloads them.

Version 0.1.19 restores source text into spare space after fitting a complete compact search page. Existing hits, visible text, source lines and continuations remain protected within the same response budget; ranking and retrieval are unchanged.

Version 0.1.7 also provides changes and trace commands: investigate a diff, follow source-backed caller paths, export JSON/Markdown, and check or refresh saved evidence. MCP equivalents change_context and trace_flow are local full-profile tools. Version 0.1.8 adds exact file/symbol selection and bounded changed-class summaries, with --class-mode expand for class-wide callers. Version 0.1.9 keeps Python docstrings and parameter types, and lists impact results nearest first. Version 0.1.10 shows the best test hit second for "tested" searches, and counts Swift Tests/ folders as tests. Version 0.1.11 counts more test file names as tests, such as _test.dart and Perl .t scripts and t/ modules. Version 0.1.12 makes doctor --client claude read the local-scope entry that claude mcp add writes to ~/.claude.json. Version 0.1.13 fills compact search pages within their budget, offers bounded deeper searches, and repairs stale navigation indexes after successful restart parsing. Version 0.1.18 restores the ready phase after a failed snapshot load is followed by a complete fallback rebuild. Incomplete recovery stays guarded.

Version 0.1.17 lets a later explicit inspection retry a failed selected-file parse after a one-second cooldown, preserving immediate-repeat and source guards. Version 0.1.16 stabilizes tied symbol pages and reduces the Docker image while preserving runtime contracts. It adds bounded online maintenance evidence; the preview and restart experiments did not justify product changes. Version 0.1.15 adds parser ownership by thread, one language-server stderr reader, bounded native recovery without static callers and release install verification on GitHub runners. Version 0.1.14 adds bounded selected-file recovery, safe navigation publication, guarded Elixir definitions and doctor probe identity. See the change investigation guide.

The agent sees 16 tools (the daily profile):

Use Tools
Find code semantic_search, fast_search, search_symbols, bootstrap, relevant_context
Read a symbol inspect_symbol, symbols, cross_references, call_graph
See structure dependencies, explore_codebase, project_summary
Plan a change impact_analysis, suggest_tests, review_change
Check the server capabilities
  • When the agent knows a symbol, inspect_symbol(symbol_name="...", task_hint="...") gives the definition, the source, the references and candidate tests in one call.
  • In an unfamiliar repository, bootstrap(task_hint="...") finds the relevant code and gives a map.
  • impact_analysis and suggest_tests help plan the checks for a change.

For all tools (about 140: rules, security scans, history, snapshots and more), add --profile full to init. The tool catalog lists them. The search details page describes ranking, the response format and the experimental rerankers.

Explicit Perl module roots are available from 0.1.32 for static resolution over discovered workspace files.

For an experimental local seven-tool surface (0.1.5 or later), use init --profile lean and restart your client. It advertises bootstrap, search_symbols, inspect_symbol, semantic_search, impact_analysis, suggest_tests and capabilities, with conditional routing instructions and 2,000-token responses. Without file watching, notify_file_changed is an eighth tool. Advanced tools require a full-profile session. This opt-in profile has no demonstrated completion benefit; see the completed pilot.

Commands for people

Run these in your project:

attocode-code-intel query "parse config"      # search the code with its own words
attocode-code-intel symbols src/app.py        # the symbols of a file
attocode-code-intel symbols --search greet    # find a symbol by name
attocode-code-intel impact src/app.py         # the files that a change can affect
attocode-code-intel deps src/app.py           # what a file imports, and what imports it
attocode-code-intel hotspots                  # the files with the most risk or complexity

Search matches the words of the code and its paths. It does not use embeddings unless you install the semantic extra.

What we measured

  • Search. We ran the 560 issues of Loc-Bench V1, with the full issue as the query. For 53.2% of them, the first five files held all files of the fix (file Acc@5 0.532). On a mix of 10 public benchmarks, file Acc@5 was 0.425. See the first-stage results and the matrix results.
  • Agents. In four studies, Claude Code (Sonnet 5.5) named the files to edit for an issue. The server did not raise file Acc@5. Each run with the server cost 1.4 to 2.1 times as much. When the agent could choose, it seldom called the server. See the agent pilot and study R3.

The R6 review study found no demonstrated review benefit. The completed R7 repair pilot also found no demonstrated benefit; its reviewed decision is to stop expansion. The 2026-10-22 investigation pilot stopped incomplete after its first task pair because structured-output/tool calls failed the frozen protocol. It provides no quality, cost or time benefit evidence.

Limits and troubleshooting

  • First search. The first tool call starts the index build. A search waits up to 15 seconds for the index. On a large repository, a search can report that the index is warming. Then search again. An empty result during warm-up does not prove that the code is absent.
  • Index location. The index is in .attocode/ in your project. When the server makes that folder, it adds a .gitignore, so the index stays out of commits.
  • What the index reads. By default the server discovers at most 50,000 eligible files and skips files over 1 MB. From 0.1.22, the discovery budget setting allows an explicit limit up to 100,000; the selected index can be smaller under its independent file limit. It skips files that .gitignore ignores, and folders that start with a dot. It also skips folders named dist, build, out, output, target, env, tmp, vendor or coverage, and binary, media and lock files. If a build-named folder contains real source, explicitly re-include it with a root .gitignore entry such as !dist/; discovery and edit refresh honor that override.
  • Languages. The base install parses Bash, C, C#, C++, CSS, Elixir, Go, HCL, HTML, Java, JavaScript, JSON, Kotlin, Lua, PHP, Python, Ruby, Rust, Scala, Swift, TOML, TypeScript, YAML and Zig. Optional grammars are loaded only when already installed or cached; installing the tree-sitter-all extra does not trigger grammar downloads during navigation. A slow grammar falls back after a 100 ms parse budget. Static imports and references are partial evidence, not compiler/type resolution.
  • Degraded parsing (development builds). Selecting a missing definition in a file with a recorded native parse failure permits one bounded retry for that source/parser generation. A failed retry reports partial evidence and an attocode-code-intel notify command to queue a file refresh. Empty results and ordinary syntax errors do not trigger this recovery.
  • Test paths. Search and test suggestions recognize conventional test folders and filenames, plus supported Kotlin/Android source sets directly under src (for example commonTest, jvmTest, androidHostTest and androidDeviceTest). Helpers in those sets count as test code even without a test filename. Custom target or flavor names are not inferred from a Test suffix alone. Short queries explicitly asking for tests put recognized test files first, preserving order within each group; longer issue descriptions keep source-first behavior. Suggestions can include helpers; verify the actual runnable tests.
  • Remove the setup. Run attocode-code-intel init --remove. It restores an entry that existed before init.
  • Server does not answer. Run attocode-code-intel doctor. If a client shows "not configured", run init for it. After a change, restart the agent. In Claude Code, /mcp shows the server state.
  • HTTP server. attocode-code-intel --transport http needs the http extra. It serves only this computer unless you set ATTOCODE_API_KEY.

For one installation for all repositories, use init --global. A global server works on the repository of its working directory, or on the workspace that a tool call names.

Teams and remote agents

Self-hosting and migration covers PostgreSQL, Redis, workers, authentication, and the dashboard. The service serves native Streamable HTTP MCP at /mcp/. The dashboard provides connection snippets and knowledge editing.

From 0.1.34 (not available in 0.1.33), opt-in explicit HTTP cancellation is available with ATTOCODE_MCP_HTTP_CANCEL=1 on an authenticated server and a random UUID4 X-Attocode-Cancellation-Id header shared by the original call and its cancellation notification. The credential, workspace and profile must match; use one HTTP worker or context affinity. It is off by default. Cancellation setup and limits cover clients without the header, process restarts and synchronous work.

From 0.1.35, init --http-cancellation configures an opt-in stdio bridge that owns the client context and forwards tool cancellation using the actual HTTP request ID. This client bridge is not in 0.1.34; existing remote configurations remain native HTTP by default. See client bridge setup and limits.

attocode-code-intel init --client all --server https://intel.example.com --repo REPOSITORY_UUID
attocode-code-intel doctor --client codex --remote

Set ATTOCODE_API_KEY in the agent's environment. Use intelligence:read for analysis and add intelligence:write for knowledge changes. Every repository operation checks membership and scope before using cached analysis. Results identify repository, source, commit, index coverage, and truncation. PostgreSQL stores shared knowledge with authorship, revision, and file anchors.

Local and remote entries coexist. Remote calls analyze committed branches or explicit revisions. Local edits remain local. To copy a particular learning to your team, review and run an explicit share:

attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID --dry-run
attocode-code-intel share --project . --learning 12 --server https://intel.example.com --repo REPOSITORY_UUID

cross_repo_search searches explicitly selected authorized repositories and retains provenance on each result.

Development

The package is in packages/code-intel of the attocode repository.

uv sync --extra dev --extra code-intel
uv run pytest -c packages/code-intel/pyproject.toml --confcutdir=packages/code-intel/tests packages/code-intel/tests
uv build --package attocode-code-intel

For routine work, use .venv/bin/python -m eval.quality quick (two minutes) or local (ten minutes). They isolate scratch and caches in a monitored 5 GiB workspace and report incomplete runs separately from passes. The quality guide covers pinned multi-language workflow checks, storage inventory, cleanup and optional CPU cloud batches.

Releases use intel-v* tags (release guide).

Product and operations guide · Tool catalog · Search details · Changelog · MIT license

Metadata

Release files for attocode-code-intel 0.1.35

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for attocode-code-intel 0.1.35
File Size Uploaded Provenance Actions
attocode_code_intel-0.1.35.tar.gz 1.4 MB With provenance Details for attocode_code_intel-0.1.35.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for attocode-code-intel 0.1.35
File Interpreter ABI Platform Actions
attocode_code_intel-0.1.35-py3-none-any.whl Python 3 none any Details for attocode_code_intel-0.1.35-py3-none-any.whl

Total release size: 2.4 MB

Release files / attocode_code_intel-0.1.35.tar.gz

Download URL attocode_code_intel-0.1.35.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
7249ce4fdcc20efc4f8c8e9fcf4c120454f047ea7135c6ee712d5fa96ae5b0f8
BLAKE2b-256 checksum
How to use checksums
6a5c06be7fe96dc6626d1d9fbb04eff2d6a7fc6c70d9e6f8c7e859d628718382
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / attocode_code_intel-0.1.35-py3-none-any.whl

Download URL attocode_code_intel-0.1.35-py3-none-any.whl
Size 973.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
33c5d1e36fa2ad7f2057ee9bce8d25e9e38ea76f17fb95c264458ee6b234ec71
BLAKE2b-256 checksum
How to use checksums
2e44d408c32f9bdf49eb3bbbf148154f7716d758b9a369e6ba0ad76ac8990a4a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for attocode-code-intel 0.1.35

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for attocode_code_intel-0.1.35.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.35 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page