Skip to main content

lab-kit

lab-kit keeps a research lab that coding agents work in. It fixes what the lab's record looks like, the method that makes a number count, and one command, lab, that both keeps the rules and shows the lab to an agent a level at a time. folio serves the same record to the operator as a live site: lab_kit.site draws the pages, and nothing is generated.

Two readers

  • The operator decides direction and resources, in conversation with the agent, and reads the lab as a site. Nothing else reaches them.
  • The agent plans, builds, runs and records, and decides everything else.

One tree

Goal           what the lab wants to be able to say
  Question     a test (answered yes, no or mixed) or an estimate (answered with what was found): what we expect, what would prove us wrong, what we know so far
    Build      something an experiment needs that has to be made first
    Reading    a look at what already exists: it suggests, and never confirms
    Experiment what is compared, what would confirm, what would refute; then what was found
      Run      one try at producing what the experiment demands; the first that finishes counts
      Result   one number from that run, with the command that prints it again
Decision       something discussed with the operator: what was seen, the options, what was decided and why
Mission        how a settled decision is being carried out: its rules, and a log a later session resumes from

Every id spells the path: G1.Q2.3. Cards are small and written for the operator. Nothing computed is kept: every state, and an experiment's outcome, is worked out from the record when it is asked for.

How a number counts

write the card -> lock -> run -> result -> review -> the number may be used on a card

Each arrow is a command that refuses when the step before it is missing. An experiment's lines, each with the result it tests, are locked before its run. The first run that finishes is the only source of its results. The reviewer is a separate session that did not do the work. Every run is listed in a file that git keeps, so one cannot be removed or rewritten quietly.

Install

uv tool install lab-kit-cli
lab init

Then ask your agent to follow .agents/skills/lab-set-up/SKILL.md. lab --help lists the sixteen commands.

The command needs Python 3.10 or later and nothing of folio. The site does: install lab-kit-cli[site] where folio serves the lab, which brings folio-kb 0.5.0 or later, and list lab_kit.site under views: in the charter of the lab's docs/ library.

Read more

  • docs/model.md: the contract. What you read, how a number becomes a result, who decides, the commands, the files.
  • method/METHOD.md: the seven rules every lab keeps.
  • skills/: lab-set-up, lab-work, lab-review, lab-talk and lab-mission. agents/: the reviewer.

Metadata

Release files for lab-kit-cli 1.7.0

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

Source distribution (sdist)

Source distribution for lab-kit-cli 1.7.0
File Size Uploaded Provenance Actions
lab_kit_cli-1.7.0.tar.gz 195.4 kB With provenance Details for lab_kit_cli-1.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lab-kit-cli 1.7.0
File Interpreter ABI Platform Actions
lab_kit_cli-1.7.0-py3-none-any.whl Python 3 none any Details for lab_kit_cli-1.7.0-py3-none-any.whl

Total release size: 312.3 kB

Release files / lab_kit_cli-1.7.0.tar.gz

Download URL lab_kit_cli-1.7.0.tar.gz
Size 195.4 kB
Tags Source
SHA-256 checksum
How to use checksums
dae2aad56256c8d4645f264ae95ae86c07f9e70fd4cfdebd7c419f1ed5184b6b
BLAKE2b-256 checksum
How to use checksums
2e59b1f4331c680991a3dfaf834dac377bd9ae041ec874fa0688177d8685fbd8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Release files / lab_kit_cli-1.7.0-py3-none-any.whl

Download URL lab_kit_cli-1.7.0-py3-none-any.whl
Size 116.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
20e1bba7beaf1634eb961b9313ff9e4c76d682470d10eaf2e037e9290e053b6f
BLAKE2b-256 checksum
How to use checksums
2b5fe76f72dc40257168c765ae355abbe15473ce48fe9ef04a03deacded9eb78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Security for lab-kit-cli 1.7.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for lab_kit_cli-1.7.0.tar.gz

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 Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.7.0 This release

2 release files Full provenance

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