kestrel-feature-code
Codebase tooling feature for Kestrel Sovereign agents — 10 tools spanning read-only inspection (read, search, diff, lint, logs) and approval-gated mutation (edit, commit, rollback, restart, test).
Installation
uv pip install kestrel-feature-code
The feature is auto-discovered by Kestrel Sovereign via the kestrel_sovereign.features entry point — install it alongside kestrel-sovereign and CodeFeature registers itself at startup.
v0.2.0 rename:
CodeEditFeature→CodeFeature. The old name is kept as a deprecated alias through v0.2.x for entry-point and import cutover; importing it emits aDeprecationWarning. Removed in v0.3.0. All@toolmethods now returnkestrel_sdk.tools.result.ToolResult(was:Dict[str, Any]); see kestrel-sovereign #1042 for the honesty contract.
Configuration
| Variable | Description |
|---|---|
KESTREL_CODE_ROOT |
Root directory of the codebase the feature operates on (default: project root) |
Tools
| Tool | Category | Description |
|---|---|---|
code_read |
DATA_ACCESS | Read a source file |
code_search |
DATA_ACCESS | Search the codebase |
code_diff |
DATA_ACCESS | Show uncommitted git changes |
code_lint |
DATA_ACCESS | Run ruff linter |
code_logs |
DATA_ACCESS | View recent application logs |
code_edit |
SYSTEM | Edit a source file (approval-gated) |
code_commit |
SYSTEM | Commit staged changes (approval-gated) |
code_rollback |
SYSTEM | Roll back to a previous commit (approval-gated) |
code_restart |
SYSTEM | Signal server restart (approval-gated) |
code_test |
SYSTEM | Run pytest (full suite is approval-gated) |
Dependencies
kestrel-sovereign-sdk>=0.14.1,<1— baseFeature,tool,ToolCategory,ToolResult
No runtime dependency on kestrel-sovereign itself; the feature operates against any codebase via KESTREL_CODE_ROOT.
Development
uv pip install -e '.[test]'
uv run pytest
License
Apache-2.0
1 maintainer
Metadata
1 maintainer
Release files for kestrel-feature-code 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kestrel_feature_code-0.2.1.tar.gz | 17.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kestrel_feature_code-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 37.1 kB
Release files / kestrel_feature_code-0.2.1.tar.gz
| Download URL | kestrel_feature_code-0.2.1.tar.gz |
|---|---|
| Size | 17.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
07177414be25116c07cd66116e94e50a49f115e9dbfdadf4b1ef2fe071336ae6
|
|
BLAKE2b-256 checksum How to use checksums |
07e8bdf6eb5bf5155c040e5cc7d2053c8743cf213ad1f24e91f8ac1418966c10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 20, 2026.
Transparency logRelease files / kestrel_feature_code-0.2.1-py3-none-any.whl
| Download URL | kestrel_feature_code-0.2.1-py3-none-any.whl |
|---|---|
| Size | 19.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b1233f5f608213b25457c29dfa82b9ddd09a8b91d8430d42c68b648c20ab2e76
|
|
BLAKE2b-256 checksum How to use checksums |
03c932c269bdb20343539a95559cd17b76ea6cc62bfbfecbccbe7688c5856163
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 20, 2026.
Transparency log
