athena-code 0.0.14__py3-none-any.whl

athena_code-0.0.14.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: athena-code
+Version: 0.0.14
+Summary: A semantic code analysis tool designed to help Claude Code navigate repositories efficiently while dramatically reducing token consumption.
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.21.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: rich>=14.2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: tasktree; extra == "dev"
+Dynamic: license-file
+
+# Athena Code Knowledge
+
+A semantic code analysis tool designed to help Claude Code navigate repositories efficiently while dramatically reducing token consumption.
+
+## Motivation
+
+Claude Code currently incurs significant token costs during repository navigation. A typical planning phase involves reading 10-20 files to understand codebase architecture, consuming substantially more tokens than the targeted modifications themselves. This linear scaling with codebase size makes work on large repositories inefficient.
+
+Most discovery queries ("What does this file contain?", "Where is function X?") don't require reading entire source files. By building a queryable semantic index, we can answer these questions using structured metadata instead, potentially reducing planning token costs by 15-30x.
+
+## What's the deal with the name?
+Athena was an Ancient Greek goddess associated with strategic wisdom, logic, crafts, architecture and discipline. She is a patron of engineers and planners, not dreamers. Seemed appropriate.
+
+One of her symbolic animals was the owl.
+
+## Installation
+
+NOTE: Athena currently only works in a Python codebase. More supported languages coming soon!
+
+Install with pipx:
+```bash
+pipx install athena-code
+```
+Requires at least Python 3.12, so if that's not installed you should do that with your system package manager. It doesn't need to be the default Python, you can leave that at whatever you want and point Pipx at Python 3.12 explicitly:
+```bash
+pipx install --python python3.12 athena-code
+```
+
+## Usage
+use `athena --help` to see up-to-date information about the available features:
+
+```
+╭─ Commands ─────────────────────────────────────────────────────────────────────╮
+│ locate          Locate entities (functions, classes, methods) by name.         │
+│ info            Get detailed information about a code entity or package.       │
+│ mcp-server      Start the MCP server for Claude Code integration.              │
+│ install-mcp     Install MCP server configuration for Claude Code.              │
+│ sync            Update @athena hash tags in docstrings.                        │
+│ status          Check docstring hash synchronization status.                   │
+│ uninstall-mcp   Remove MCP server configuration from Claude Code.              │
+╰────────────────────────────────────────────────────────────────────────────────╯
+```
+
+Generally, you will install `athena` and then:
+- Run `athena sync` in your codebase. This will add Athena's hashes to all the docstrings and allow `athena` to detect code changes that have invalidated the docstrings.
+- After code changes, run `athena status` to see a table of all the functions that have been updated and may have had their docstrings invalidated.
+- Update the necessary docstrings and then run `athena sync` again to update all the necessary hashes.
+
+If you want to find an entity in the codebase, then just run `athena locate <entity>` to get details on the file and lines the entity occupies:
+```bash
+> athena locate get_task
+ Kind    Path                    Extent  
+ method  src/tasktree/parser.py  277-286
+```
+
+Once you know where a thing is, then you can ask for info about it:
+```bash
+> athena info src/tasktree/parser.py:get_task
+{
+  "method": {
+    "name": "Recipe.get_task",
+    "path": "src/tasktree/parser.py",
+    "extent": {
+      "start": 277,
+      "end": 286
+    },
+    "sig": {
+      "name": "get_task",
+      "args": [
+        {
+          "name": "self"
+        },
+        {
+          "name": "name",
+          "type": "str"
+        }
+      ],
+      "return_type": "Task | None"
+    },
+    "summary": "Get task by name.\n\n        Args:\n            name: Task name (may be namespaced like 'build.compile')\n\n        Returns:\n            Task if found, None otherwise\n        "
+  }
+}
+```
+
+## Install Claude MCP integrations
+
+Athena includes Model Context Protocol (MCP) integration, exposing code navigation capabilities as first-class tools in Claude Code.
+
+### Benefits
+
+- **Native tool discovery** — Tools appear in Claude Code's capabilities list
+- **Structured I/O** — Type-safe parameters and responses
+
+### Available Tools
+
+- **`ack_locate`** — Find Python entity location (file path + line range)
+
+### Installation
+
+```bash
+athena install-mcp
+```
+
+This automatically configures Claude Code by adding the MCP server entry to your config file. You will need to restart Claude Code for changes to take effect.
+
+**Uninstalling:**
+
+If you don't like using your Anthropic tokens more efficiently to generate better code, for some reason, then:
+```bash
+athena uninstall-mcp
+```
+to remove the MCP integration
+
+## Usage Workflow
+
+```bash
+cd /path/to/repository
+athena locate validateSession  # Find the locations of entities in the codebase
+```
+
+## Contributing
+
+This is an active development project. Early-stage contributions welcome, particularly:
+
+- Tree-sitter AST extraction improvements
+- Language-specific signature formatting
+- LLM prompt engineering for summary quality
+- Performance benchmarking
+
+## License
+
+MIT - See LICENSE

athena_code-0.0.14.dist-info/RECORD

@@ -0,0 +1,24 @@
+athena/README.md,sha256=JL20Ydnw7Hj-YQsooxVcRTO7K3-XAim0wNQB6FFa2pU,5397
+athena/__init__.py,sha256=8aCUb_2UakYGL8Co0IqXxD3A_gedQc2HTfKfRE492Q0,324
+athena/__main__.py,sha256=pScNVxkWfc2jryr07rhQ4xNo-MPoPIaavOjrXWHXUaU,66
+athena/cli.py,sha256=vx9zDwMruPAHhxs5ljdGUaVZywLxnSKULBS0utQkcH0,11501
+athena/docstring_updater.py,sha256=IB3WDW55lH33Ti8NjUDjL2Q4R48BdvbDJ-xz_W_8UTc,5046
+athena/entity_path.py,sha256=1Gg4OdNOdqkMv_L_tjUsSsH6QiczccOuUhBf3Vg0GXU,4414
+athena/hashing.py,sha256=hCUqX1xYiwTfmetrvtA51zIUZVU3Ij0d9WvJVWhak_8,4749
+athena/info.py,sha256=VPXf60LBjCx1KXMO1bnY-UQr4rcPkD4J4bRqGHbIJts,2935
+athena/locate.py,sha256=Tl9-Ff86QQosqrPlTPsQisd7rXZk7EDbpuvdsYgzD00,1799
+athena/mcp_config.py,sha256=1H9K6DUpBno3F4fvLWoUqqWSzUufdE7toucJZY2Xk94,3084
+athena/mcp_server.py,sha256=3i_0quaD5KnUbyVZwWXF34PziCjpYSDFLxOpj_RCvKU,6413
+athena/models.py,sha256=pkK91Zr1lRn-iwUyV76v5cHDeuNkGVDXgrWsXTJpRtw,2063
+athena/repository.py,sha256=j2IMP47I1_qgr2sBbD24I5RH_Zf-rg-LLzdQB0PAwQI,1807
+athena/status.py,sha256=1h8Y_BofMxVvH2laFHuiu0flSVXjdCjVSZfxpWLtSSE,2806
+athena/sync.py,sha256=-ljJe4HrvxLImsZaa_XbDkfWt0TnsZYTkvrzYM0RRGk,23819
+athena/parsers/__init__.py,sha256=FavxGyvYQYYknzzmvCHQ3_d_W2cJZKAaWXvafywxb9A,580
+athena/parsers/base.py,sha256=ObnAZ7X02dDY7cjo6E0X8rQCuTMJoJ27u51GoHlCMBU,1221
+athena/parsers/python_parser.py,sha256=XUHX8mtJGNbgs3E14JblioadLPwAHzrDnID36lgve3Y,26332
+athena_code-0.0.14.dist-info/licenses/LICENSE,sha256=LxfkzMUj9-IB0KuB3Lnt_usK0XcsMM9d1_bqwCbLCM0,1069
+athena_code-0.0.14.dist-info/METADATA,sha256=SBN2szqKkrREu9odvfjlr4ZJHxKQVUW-ZUqc2Gq9hzY,6112
+athena_code-0.0.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+athena_code-0.0.14.dist-info/entry_points.txt,sha256=_jGdP9-6-_1tCbmQKuxzrGev7MwLO3eJj7SaS9GYDEk,63
+athena_code-0.0.14.dist-info/top_level.txt,sha256=EN8_eWXgVxKOxXtKLSOsY8-K2CSa7JA1b03zO18n6II,7
+athena_code-0.0.14.dist-info/RECORD,,

athena_code-0.0.14.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

athena_code-0.0.14.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ack = athena.cli:app
+athena = athena.cli:app

athena_code-0.0.14.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kevinchannon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

athena_code-0.0.14.dist-info/top_level.txt

@@ -0,0 +1 @@
+athena