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.4

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.4
File
ralonlock-0.1.4-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
ralonlock-0.1.4-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.4-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.4-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
ralonlock-0.1.4-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.4-py3-none-win_amd64.whl

Download URL ralonlock-0.1.4-py3-none-win_amd64.whl
Size 869.0 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
b7426826566c05630579bdcf0fb7b99d0258a84ee20bd4ff2971cf8932d97511
BLAKE2b-256 checksum
How to use checksums
b668577da5395b37c4edb9c95b3c739afd83d53d97f5db2f514f2a6e872edd70
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.4-py3-none-manylinux_2_17_x86_64.musllinux_1_2_x86_64.whl

Download URL ralonlock-0.1.4-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
cafcbd9459d135d60d7c4cea79c0ca41e9160b99aff74cf26f2bb41565579fee
BLAKE2b-256 checksum
How to use checksums
063c733517f16529171d88b7bdf624391039b859268153dea3517fb56f7db5d7
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.4-py3-none-manylinux_2_17_aarch64.musllinux_1_2_aarch64.whl

Download URL ralonlock-0.1.4-py3-none-manylinux_2_17_aarch64.musllinux_1_2_aarch64.whl
Size 911.5 kB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0c1a882f5f15f7df5341f55bdaffee199bc7001d90f5e0d507c332f9622defd3
BLAKE2b-256 checksum
How to use checksums
1623841981c1bfb773a32aa69230ab888e357f5021f30a17abff7f8098d4ed23
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.4-py3-none-macosx_11_0_arm64.whl

Download URL ralonlock-0.1.4-py3-none-macosx_11_0_arm64.whl
Size 797.4 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
882fd24ad09a236f6603430a86d7fa19af90eb415dd58fd1cbf802d39e3dbdce
BLAKE2b-256 checksum
How to use checksums
aa992a0828c5ed6caf82267947a270e4e565d92ad020ef9fdadf4255dc85e2da
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.4-py3-none-macosx_10_12_x86_64.whl

Download URL ralonlock-0.1.4-py3-none-macosx_10_12_x86_64.whl
Size 896.8 kB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
bfe89b41fcc058f705439cabada3f99009eb694689a049c1d34ed6384a819644
BLAKE2b-256 checksum
How to use checksums
109d030d3bce89d740dea4b27e2dd45ca7fd3c3d252d3d2d58cdf001883f7378
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

0.1.5

5 release files

This release

0.1.4 This release

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