Skip to main content

ralon

agent.lock declares what AI agents may not modify. Ralon makes the kernel agree.

$ npm install -g ralonlock       # the command it installs is `ralon`
$ ralon init                     # write a starter agent.lock
$ ralon check src/auth.ts        # is this path protected? exits 1 if it is
$ ralon run -- claude            # run an agent that cannot touch them

Without installing: npx ralonlock check src/auth.ts.

Inside ralon run — and in every process it spawns — the protected paths are read-only to the kernel. Not a linter, not a hook the agent can talk its way past. open() returns EROFS, rm returns EACCES.

# agent.lock
version: 1

protect:
  - src/auth.ts
  - .env
  - config/**

This package ships prebuilt binaries and picks the right one for your platform. run enforces on Linux; init, check and status work everywhere, which is what CI and pre-commit hooks need.

Installing through npm adds a Node process in front of each invocation. For a long-running agent that is irrelevant, but cargo install ralon or the release binaries skip it.

Full documentation, the threat model and the tested limitations: https://github.com/stoneware-dev/Ralon

Apache-2.0.

Metadata

Release files for ralonlock 0.1.5

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

Built distributions (wheels)

Table of built distributions (wheels) for ralonlock 0.1.5
File
ralonlock-0.1.5-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
ralonlock-0.1.5-py3-none-manylinux_2_17_x86_64.musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64, Linux glibc 2.17+ x86-64 Details
ralonlock-0.1.5-py3-none-manylinux_2_17_aarch64.musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64, Linux glibc 2.17+ ARM64 Details
ralonlock-0.1.5-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
ralonlock-0.1.5-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details

Total release size: 4.5 MB

Release files / ralonlock-0.1.5-py3-none-win_amd64.whl

Download URL ralonlock-0.1.5-py3-none-win_amd64.whl
Size 869.6 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
29e9cb8d97a32418fc996dcd31a4bb4b2369d37a9bc235fda824c0a5deadfbc5
BLAKE2b-256 checksum
How to use checksums
0ab515fff169e0f398f4bdc9cd73fb64550df4c493d58d73874cbe98da7faa53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 25, 2026.

Transparency log

Release files / ralonlock-0.1.5-py3-none-manylinux_2_17_x86_64.musllinux_1_2_x86_64.whl

Download URL ralonlock-0.1.5-py3-none-manylinux_2_17_x86_64.musllinux_1_2_x86_64.whl
Size 1.0 MB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
2ce9d7d63f61717fa1a46f9cdf999db02893ca6e66fa5fcd9f5840f2cef1d781
BLAKE2b-256 checksum
How to use checksums
cda8f9c4706aac29b8e30e89e29349c30c32a2f5c656bdadc2d816d55365a56d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 25, 2026.

Transparency log

Release files / ralonlock-0.1.5-py3-none-manylinux_2_17_aarch64.musllinux_1_2_aarch64.whl

Download URL ralonlock-0.1.5-py3-none-manylinux_2_17_aarch64.musllinux_1_2_aarch64.whl
Size 911.7 kB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
32be96f7ba6575fbf0271bf581538e3f17d3b299c8b31759849646c7cec2f3a3
BLAKE2b-256 checksum
How to use checksums
2cf0d7911f5451a47b0ca3876f60970b46f2404857a38a609732b6df73fa1dd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 25, 2026.

Transparency log

Release files / ralonlock-0.1.5-py3-none-macosx_11_0_arm64.whl

Download URL ralonlock-0.1.5-py3-none-macosx_11_0_arm64.whl
Size 797.7 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b0420113d85b9908c0c019f961aba797f4106f3aae4aa5612c39d20a36d7b2d0
BLAKE2b-256 checksum
How to use checksums
40b85557f6e8940deeb8392d5fe061fc6d5954c13a122c81d460335aa5b664db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 25, 2026.

Transparency log

Release files / ralonlock-0.1.5-py3-none-macosx_10_12_x86_64.whl

Download URL ralonlock-0.1.5-py3-none-macosx_10_12_x86_64.whl
Size 897.1 kB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
5b9d0b38e61bd43e40a6df1d7ed570e4ea0fb72eb852e23bc2ca8c4c36b38ad0
BLAKE2b-256 checksum
How to use checksums
998dd1ad124ba3d6e965eeee41dae178d1557440f6d693cec516a7228d910a94
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Aug 25, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.7

5 release files

0.1.6

5 release files

This release

0.1.5 This release

5 release files

0.1.4

5 release files

0.1.3

5 release files

0.1.2

5 release files

0.1.1

5 release files

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