nullain-tools

Built-in coding tools for the Nullain Agent SDK — paged file reads, safe edits, ripgrep-backed search, checkpoints/undo, git operations, and sandboxed shell execution.

This package requires nullain-sdk (installed automatically as a dependency) and is registered into an Agent automatically — most users never import it directly.

Install

pip install nullain-tools

nullain-sdk pulls this in as a dependency, so a plain pip install nullain-sdk already gets you the full built-in toolset.

What's inside

Tool Description
read_file Numbered, paged reads (cat -n style); truncates absurdly long lines.
write_file / edit_file / multi_edit Safe writes — exact-match edits reject ambiguous matches and no-ops; multi_edit applies a batch of hunks atomically.
grep / glob / list_directory ripgrep-backed search with a pure-Python fallback; glob matching; directory listing.
bash Shell execution via explicit argv (never shell=True), inside the SDK's OS-level sandbox when available.
git_status / git_diff / git_commit Controlled git operations scoped to the workspace.
web_fetch Fetch a URL and return HTML converted to plain text.
todo_write / undo Session todo tracking; restore the most recent pre-write checkpoint of a file.

Every tool that reads file content (read_file, grep) or reports what changed (edit_file, multi_edit) redacts common secret patterns (API keys, tokens) before the output reaches the model or a log.

See docs/tools.md in the main repository for the full reference, including each tool's capability requirements and permission level.

License

MIT — see LICENSE.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nettylinux from gravatar.com nettylinux

Credits

Author: Nullain

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Tags

agent ai coding-agent llm nullain tools

Classifiers

Report project as malware

Download files

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

Source Distribution

nullain_tools-0.1.0.tar.gz (18.1 kB view details)

Uploaded Source

Built Distribution

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

nullain_tools-0.1.0-py3-none-any.whl (22.9 kB view details)

Uploaded Python 3

File details

Details for the file nullain_tools-0.1.0.tar.gz.

File metadata

  • Download URL: nullain_tools-0.1.0.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nullain_tools-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0d785545a79cc5562f9fa8d1a05580cc3a5cdb867d55ddc0a12e953dd06c9478
MD5 466f52c2ddcf3014153b31157409e763
BLAKE2b-256 c1f1805705308d17ee8727898d23bf2abce6cd68475438ec99b5bb78de3f170f

See more details on using hashes here.

Provenance

The following attestation bundles were made for nullain_tools-0.1.0.tar.gz:

Publisher: release.yml on netty-linux/nullain-agent-sdk

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

File details

Details for the file nullain_tools-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: nullain_tools-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 22.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nullain_tools-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3eca9ae692ae22b6555dcf1899c5cb895065c203a73d0f672bdbb4b8c04e033c
MD5 4045e1a78390e497f597dfac27ad432b
BLAKE2b-256 d71d588f6ecbd992a04697dc22571c5bc811fc2a05824f3028de8f7aa2435b94

See more details on using hashes here.

Provenance

The following attestation bundles were made for nullain_tools-0.1.0-py3-none-any.whl:

Publisher: release.yml on netty-linux/nullain-agent-sdk

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