knowing
Self-adapting code intelligence engine. Gives AI agents ranked, graph-aware context instead of grep results. Gets smarter with scale, not dumber.
This is the Python wrapper package that downloads and runs the knowing binary.
Install and verify
pip install knowing
knowing version # should print the version
Configure your agent
Add to your agent's MCP config (.mcp.json for Claude Code, .cursor/mcp.json for Cursor, .vscode/mcp.json for VS Code, see all):
{
"mcpServers": {
"knowing": {
"command": "knowing",
"args": ["mcp", "--watch"],
"transport": "stdio"
}
}
}
The MCP server auto-indexes your repo on first launch (10-30 seconds). No model downloads, no API keys required.
First useful query
Ask your agent:
"Use the context_for_task tool to find symbols related to [something you know exists in your code]."
You should see ranked symbols with scores and file paths. If results are empty, the repo is still indexing. If results seem unrelated, use specific symbol names in your task description.
What it does
knowing indexes code across 23 extractors (Go, TypeScript, Python, Rust, Java, C#, and more) into a content-addressed knowledge graph. 38 edge types, 28 MCP tools, 277 equivalence classes bridging task vocabulary to code symbols.
P@10 = 0.330 across 302 tasks, 17 repos, 8 languages. 13 self-adapting mechanisms. 3.79x codegraph, 6.00x GitNexus.
CLI usage
knowing add . # index a repo
knowing context -task "refactor auth" -format gcf # ranked context
knowing test-scope -files internal/auth/handler.go # affected tests
knowing why -task "refactor auth" -symbol "SessionHandler" # explain ranking
knowing enrich lsp # LSP enrichment for higher-quality edges
Documentation
Full docs at https://blackwell-systems.github.io/knowing
1 maintainer
Metadata
1 maintainer
Release files for knowing 0.16.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| knowing-0.16.0-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| knowing-0.16.0-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| knowing-0.16.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| knowing-0.16.0-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
Total release size: 12.7 kB
Release files / knowing-0.16.0-py3-none-manylinux2014_x86_64.whl
| Download URL | knowing-0.16.0-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 kB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
3e6bf7fd06365172707a6603a2325f28c141807c7a390aa37b616a9e87f39cf7
|
|
BLAKE2b-256 checksum How to use checksums |
f900060a8f1ee51eb4e176ec23756a798151df67719af439c3b3e8a2b62a1dcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / knowing-0.16.0-py3-none-manylinux2014_aarch64.whl
| Download URL | knowing-0.16.0-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 3.2 kB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
32fa5d46723f1aff8d1729d91ad4164256cbca579e2befde3d51231fce9c218d
|
|
BLAKE2b-256 checksum How to use checksums |
2ed6cbca73466878626838037e7a211f72b447182c0ce74431f9845d51a94896
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / knowing-0.16.0-py3-none-macosx_11_0_arm64.whl
| Download URL | knowing-0.16.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.2 kB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
63a06f297a9c41a910a8377ef386602a97fa5f68115fc3275602ede6c422bc89
|
|
BLAKE2b-256 checksum How to use checksums |
de4e0e640794bbd7f21d3f9da741605c011d33d964cd396917a5ede50845f2e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / knowing-0.16.0-py3-none-macosx_10_12_x86_64.whl
| Download URL | knowing-0.16.0-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.2 kB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
3c7c21ce16f7d2d355c13fb7cc4658c9e4f83af1d3ed8a0363dca5e93df1f049
|
|
BLAKE2b-256 checksum How to use checksums |
f6593cf6746ff49ca44e0ddcfc6c2840cb9ced4b5b9d471cf6ed1c65ef4f552b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
