cairn

Use it

With the cairn tool:

cairn add cairn@^0.3.0

Which writes cairn.toml, and the lakefile and SwiftPM lines that it keeps in step:

[dependencies]
cairn = "^0.3.0"

cairn.toml

[[require]]
name = "cairn"
scope = "iamnbutler"
version = "^0.3.0"

lean/lakefile.toml

.package(url: "https://cairn.registry.nexthub.sh/git/iamnbutler/cairn.git", from: "0.3.0")

Package.swift

Versions

Version	Published	Commit	Claims	Docs
0.5.2	Oct 26, 2026	`23f0836cc9`	78 active6 retired115 moved	docs
0.5.1	Oct 26, 2026	`3616efdef0`	78 active6 retired115 moved	docs
0.5.0	Oct 26, 2026	`486e8ce6e7`	77 active6 retired115 moved	docs
0.4.1	Oct 26, 2026	`a6a35fb372`	54 active6 retired115 moved	docs
0.4.0	Oct 26, 2026	`f107007b70`	52 active6 retired115 moved	docs
0.3.0	Oct 25, 2026	`60c448329b`	51 active6 retired115 moved	docs
0.2.5	Oct 25, 2026	`ea05c5e30d`	119 active3 retired44 moved	docs
0.2.4	Oct 25, 2026	`654c6695ee`	119 active3 retired44 moved	docs
0.2.3	Oct 25, 2026	`8ecf96ee6b`	119 active3 retired44 moved	docs
0.2.2	Oct 25, 2026	`885b585520`	119 active3 retired44 moved	docs
0.2.1	Oct 25, 2026	`d08381db7b`	114 active3 retired44 moved	docs
0.2.0	Oct 25, 2026	`16b70b80d6`	108 active3 retired44 moved	docs
0.1.3	Oct 25, 2026	`aea142ce26`	100 active2 retired44 moved	docs
0.1.2	Oct 25, 2026	`597dea82d5`	100 active2 retired44 moved	docs

What changed in 0.3.0

Claims new, retired or moved since 0.2.5.

Id	Change	Kind	Claim
`cairn^1`	moved:cairn_examples	move	Increment
`cairn^2`	moved:cairn_examples	move	Reset
`cairn^3`	moved:cairn_examples	place	Counter window
`cairn^4`	moved:cairn_examples	flow	Count to three
`cairn^5`	moved:cairn_examples	flow	Start over
`cairn^101`	moved:cairn_examples	move	Type a new item
`cairn^102`	moved:cairn_examples	move	Add
`cairn^103`	moved:cairn_examples	move	Toggle an item
`cairn^104`	moved:cairn_examples	move	Delete an item
`cairn^105`	moved:cairn_examples	invariant	Items left
`cairn^106`	moved:cairn_examples	place	Basics window
`cairn^107`	moved:cairn_examples	flow	Add two items and finish one
`cairn^108`	moved:cairn_examples	flow	Blank text adds nothing
`cairn^109`	moved:cairn_examples	flow	Add an item, then delete it
`cairn^201`	moved:cairn_examples	place	Todos window
`cairn^202`	moved:cairn_examples	move	New todo
`cairn^203`	moved:cairn_examples	move	Mark all as complete
`cairn^204`	moved:cairn_examples	move	Complete a todo
`cairn^205`	moved:cairn_examples	move	Edit a todo
`cairn^206`	moved:cairn_examples	move	Delete a todo
`cairn^207`	moved:cairn_examples	move	Edit field
`cairn^208`	moved:cairn_examples	move	All
`cairn^209`	moved:cairn_examples	move	Active
`cairn^210`	moved:cairn_examples	move	Completed
`cairn^211`	moved:cairn_examples	move	Clear completed
`cairn^212`	moved:cairn_examples	invariant	Counter and ids
`cairn^216`	moved:cairn_examples	flow	Add two todos and complete one
`cairn^217`	moved:cairn_examples	flow	Blank text adds nothing
`cairn^218`	moved:cairn_examples	flow	Edit a todo and save with Enter
`cairn^219`	moved:cairn_examples	flow	Saving a blank edit deletes the todo
`cairn^220`	moved:cairn_examples	flow	Escape cancels an edit
`cairn^221`	moved:cairn_examples	flow	The Active filter hides completed todos
`cairn^222`	moved:cairn_examples	flow	Clear completed
`cairn^223`	moved:cairn_examples	flow	Mark all as complete, then undo it
`cairn^224`	moved:cairn_examples	flow	A new todo under the Completed filter
`cairn^225`	retired	invariant	The list is the filter applied to the todos
`cairn^226`	new, moved:cairn_examples	invariant	The list is the filter applied to the todos
`cairn^401`	moved:cairn_examples	move	Start / Stop
`cairn^402`	moved:cairn_examples	move	Lap
`cairn^403`	moved:cairn_examples	move	Reset
`cairn^404`	moved:cairn_examples	move	Save laps
`cairn^405`	moved:cairn_examples	move	Load laps
`cairn^406`	moved:cairn_examples	place	Clock window
`cairn^407`	moved:cairn_examples	flow	Two laps
`cairn^408`	moved:cairn_examples	flow	Start over
`cairn^409`	moved:cairn_examples	invariant	Pending requests have fresh ids
`cairn^450`	moved:cairn_examples	place	Tray menu
`cairn^451`	moved:cairn_examples	place	Recent Items submenu
`cairn^452`	moved:cairn_examples	place	Overlay panel
`cairn^453`	moved:cairn_examples	move	Open the menu
`cairn^454`	moved:cairn_examples	move	Show Overlay
`cairn^455`	moved:cairn_examples	move	Keep Recent Items
`cairn^456`	moved:cairn_examples	move	Add Item
`cairn^457`	moved:cairn_examples	move	Recent item
`cairn^458`	moved:cairn_examples	move	Clear Recent Items
`cairn^459`	moved:cairn_examples	move	Quit Tray
`cairn^460`	moved:cairn_examples	invariant	At most five recent items
`cairn^461`	moved:cairn_examples	flow	Show the overlay
`cairn^462`	moved:cairn_examples	flow	Add an item and pick it
`cairn^501`	moved:cairn_examples	move	Reload
`cairn^502`	moved:cairn_examples	move	Fit
`cairn^503`	moved:cairn_examples	place	Gallery window
`cairn^504`	moved:cairn_examples	invariant	Pending loads have fresh ids
`cairn^505`	moved:cairn_examples	flow	Reload, then fit inside
`cairn^506`	moved:cairn_examples	move	Load 24
`cairn^507`	moved:cairn_examples	move	Cancel
`cairn^508`	moved:cairn_examples	flow	Load many, then cancel
`cairn^509`	moved:cairn_examples	move	Reload a tile
`cairn^510`	moved:cairn_examples	invariant	Tiles fit the window at every size
`cairn^511`	moved:cairn_examples	invariant	Tiles are at least 180 points wide
`cairn^512`	moved:cairn_examples	move	Next page
`cairn^513`	moved:cairn_examples	invariant	A dropped thumbnail waits to be loaded again
`cairn^913`	retired	assume	http sends the request as given and returns the response as received
`cairn^971`	retired	assume	A secret is read from the environment or its file, and never shown
`cairn^972`	new	assume	The Keychain keeps what it was given for this app
`cairn^973`	new	assume	Captured reply fields go to the Keychain and never to Lean
`cairn^974`	new	assume	http sends the request as given, with its secret header, and returns the response as received
`cairn^975`	new	assume	An environment secret is read from the environment or its file, and never shown
`cairn^1020`	new	assume	Secure event input is on exactly while a secure field has focus

Claims in 0.3.0

Every id this package has issued, as its claims.lock held them at this version. An id never moves or changes meaning: the registry refuses a version that drops, renumbers or redefines one. The claim pages show each claim by place, with what it does and its evidence.

Id	Kind	Status	Claim
`cairn^1`	move	moved:cairn_examples	Increment
`cairn^2`	move	moved:cairn_examples	Reset
`cairn^3`	place	moved:cairn_examples	Counter window
`cairn^4`	flow	moved:cairn_examples	Count to three
`cairn^5`	flow	moved:cairn_examples	Start over
`cairn^6`	invariant	retired	Moves never leave a press in progress
`cairn^7`	assume	active	The host reports clicks where they happen
`cairn^101`	move	moved:cairn_examples	Type a new item
`cairn^102`	move	moved:cairn_examples	Add
`cairn^103`	move	moved:cairn_examples	Toggle an item
`cairn^104`	move	moved:cairn_examples	Delete an item
`cairn^105`	invariant	moved:cairn_examples	Items left
`cairn^106`	place	moved:cairn_examples	Basics window
`cairn^107`	flow	moved:cairn_examples	Add two items and finish one
`cairn^108`	flow	moved:cairn_examples	Blank text adds nothing
`cairn^109`	flow	moved:cairn_examples	Add an item, then delete it
`cairn^201`	place	moved:cairn_examples	Todos window
`cairn^202`	move	moved:cairn_examples	New todo
`cairn^203`	move	moved:cairn_examples	Mark all as complete
`cairn^204`	move	moved:cairn_examples	Complete a todo
`cairn^205`	move	moved:cairn_examples	Edit a todo
`cairn^206`	move	moved:cairn_examples	Delete a todo
`cairn^207`	move	moved:cairn_examples	Edit field
`cairn^208`	move	moved:cairn_examples	All
`cairn^209`	move	moved:cairn_examples	Active
`cairn^210`	move	moved:cairn_examples	Completed
`cairn^211`	move	moved:cairn_examples	Clear completed
`cairn^212`	invariant	moved:cairn_examples	Counter and ids
`cairn^213`	invariant	retired	The list is the filter applied to the todos
`cairn^214`	assume	active	The host reports a double click as a second click
`cairn^215`	move	retired	Back through filters
`cairn^216`	flow	moved:cairn_examples	Add two todos and complete one
`cairn^217`	flow	moved:cairn_examples	Blank text adds nothing
`cairn^218`	flow	moved:cairn_examples	Edit a todo and save with Enter
`cairn^219`	flow	moved:cairn_examples	Saving a blank edit deletes the todo
`cairn^220`	flow	moved:cairn_examples	Escape cancels an edit
`cairn^221`	flow	moved:cairn_examples	The Active filter hides completed todos
`cairn^222`	flow	moved:cairn_examples	Clear completed
`cairn^223`	flow	moved:cairn_examples	Mark all as complete, then undo it
`cairn^224`	flow	moved:cairn_examples	A new todo under the Completed filter
`cairn^225`	invariant	retired	The list is the filter applied to the todos
`cairn^226`	invariant	moved:cairn_examples	The list is the filter applied to the todos
`cairn^301`	place	moved:yap	Menu bar menu
`cairn^302`	move	moved:yap	Copy Last Transcript
`cairn^303`	move	moved:yap	Recent transcript
`cairn^304`	move	moved:yap	Keep Transcripts
`cairn^305`	move	moved:yap	Press Return After Dictating
`cairn^306`	move	moved:yap	Dictate with Key
`cairn^307`	move	moved:yap	Open Transcripts Folder
`cairn^308`	move	moved:yap	Edit Dictionary
`cairn^309`	move	moved:yap	Edit Settings
`cairn^310`	move	moved:yap	Grant Accessibility Access
`cairn^311`	invariant	moved:yap	A shortcut never sends
`cairn^312`	invariant	moved:yap	Hold to talk, tap to latch: 300 ms
`cairn^313`	invariant	moved:yap	One recording at a time
`cairn^314`	invariant	moved:yap	Every recording ends
`cairn^315`	invariant	moved:yap	Kept before it is typed
`cairn^316`	invariant	moved:yap	A failed type is kept and flagged
`cairn^317`	invariant	moved:yap	Late and cancelled replies never type
`cairn^318`	invariant	moved:yap	Each clip is typed at most once
`cairn^319`	invariant	moved:yap	Fixes replace whole words
`cairn^320`	invariant	moved:yap	Retention never deletes today
`cairn^321`	invariant	moved:yap	Only the first 25 terms are sent
`cairn^322`	invariant	moved:yap	Recent Transcripts holds five
`cairn^323`	invariant	moved:yap	Too short, silent or nowhere to type: never sent
`cairn^330`	assume	moved:yap	The host reports the dictation key and every other key
`cairn^331`	assume	moved:yap	The host delivers the ticks it is asked for
`cairn^332`	assume	moved:yap	The host answers requests by id, in order of commands
`cairn^333`	assume	moved:yap	The host reports the microphone faithfully
`cairn^334`	assume	moved:yap	The host transcribes the samples it was asked for
`cairn^335`	assume	moved:yap	The host types into the app it was given
`cairn^336`	assume	moved:yap	The host reports config.json and dictionary.txt when they change
`cairn^337`	assume	moved:yap	The host lists day files and today by the local calendar
`cairn^340`	flow	moved:yap	Turn Dictate with Key off
`cairn^341`	flow	moved:yap	Keep Transcripts off and on again
`cairn^342`	move	moved:yap	Quit Yap (Cairn)
`cairn^343`	move	moved:yap	Grant Microphone Access
`cairn^344`	move	moved:yap	Open the menu
`cairn^345`	place	moved:yap	Overlay panel
`cairn^346`	invariant	moved:yap	The original Yap keeps its key
`cairn^347`	invariant	moved:yap	A mark waits for the appends
`cairn^348`	assume	moved:yap	The host reports the microphone's start or its failure
`cairn^349`	invariant	moved:yap	The overlay waits for the microphone
`cairn^350`	invariant	moved:yap	Keys wait for the microphone
`cairn^351`	invariant	moved:yap	Hold to talk, tap to latch: 300 ms, timed as the original
`cairn^399`	place	moved:yap	Overlay panel
`cairn^401`	move	moved:cairn_examples	Start / Stop
`cairn^402`	move	moved:cairn_examples	Lap
`cairn^403`	move	moved:cairn_examples	Reset
`cairn^404`	move	moved:cairn_examples	Save laps
`cairn^405`	move	moved:cairn_examples	Load laps
`cairn^406`	place	moved:cairn_examples	Clock window
`cairn^407`	flow	moved:cairn_examples	Two laps
`cairn^408`	flow	moved:cairn_examples	Start over
`cairn^409`	invariant	moved:cairn_examples	Pending requests have fresh ids
`cairn^450`	place	moved:cairn_examples	Tray menu
`cairn^451`	place	moved:cairn_examples	Recent Items submenu
`cairn^452`	place	moved:cairn_examples	Overlay panel
`cairn^453`	move	moved:cairn_examples	Open the menu
`cairn^454`	move	moved:cairn_examples	Show Overlay
`cairn^455`	move	moved:cairn_examples	Keep Recent Items
`cairn^456`	move	moved:cairn_examples	Add Item
`cairn^457`	move	moved:cairn_examples	Recent item
`cairn^458`	move	moved:cairn_examples	Clear Recent Items
`cairn^459`	move	moved:cairn_examples	Quit Tray
`cairn^460`	invariant	moved:cairn_examples	At most five recent items
`cairn^461`	flow	moved:cairn_examples	Show the overlay
`cairn^462`	flow	moved:cairn_examples	Add an item and pick it
`cairn^501`	move	moved:cairn_examples	Reload
`cairn^502`	move	moved:cairn_examples	Fit
`cairn^503`	place	moved:cairn_examples	Gallery window
`cairn^504`	invariant	moved:cairn_examples	Pending loads have fresh ids
`cairn^505`	flow	moved:cairn_examples	Reload, then fit inside
`cairn^506`	move	moved:cairn_examples	Load 24
`cairn^507`	move	moved:cairn_examples	Cancel
`cairn^508`	flow	moved:cairn_examples	Load many, then cancel
`cairn^509`	move	moved:cairn_examples	Reload a tile
`cairn^510`	invariant	moved:cairn_examples	Tiles fit the window at every size
`cairn^511`	invariant	moved:cairn_examples	Tiles are at least 180 points wide
`cairn^512`	move	moved:cairn_examples	Next page
`cairn^513`	invariant	moved:cairn_examples	A dropped thumbnail waits to be loaded again
`cairn^901`	assume	active	The Swift frame decoder agrees with Lean's
`cairn^902`	assume	active	Lean decodes what the Swift event encoder writes
`cairn^903`	assume	active	UTF-16 offsets and scalar indices convert exactly
`cairn^904`	assume	active	The text-input shadow predicts Lean's field
`cairn^905`	assume	active	Input-method geometry agrees with Lean's caret
`cairn^906`	assume	active	The host's text metrics are what layout assumes
`cairn^907`	assume	active	Carets follow the painted glyphs
`cairn^908`	assume	active	The host's clock is monotonic milliseconds
`cairn^909`	assume	active	The host wakes Lean by wake
`cairn^910`	assume	active	readFile replies with the file's bytes, or failed
`cairn^911`	assume	active	writeFile is atomic, and replies done only when the bytes are there
`cairn^912`	assume	active	playSound starts a known sound and refuses an unknown one
`cairn^913`	assume	retired	http sends the request as given and returns the response as received
`cairn^914`	assume	active	The host answers every request exactly once, with its id
`cairn^915`	assume	active	every ms ticks while started and never after it is stopped
`cairn^940`	assume	active	The native menu shows exactly the frame's menu records
`cairn^941`	assume	active	Choosing a menu item reports that item's ref
`cairn^942`	assume	active	Opening and closing the menu are reported once each
`cairn^943`	assume	active	An overlay panel never takes focus or clicks
`cairn^944`	assume	active	An overlay panel is where its anchor says
`cairn^960`	assume	active	appendFile adds exactly the bytes at the end, or fails and adds nothing
`cairn^961`	assume	active	listDir lists exactly the directory's names, sorted
`cairn^962`	assume	active	deleteFile removes a file or a link, never a directory
`cairn^963`	assume	active	watchFile reports every change to its file, and nothing after its stop
`cairn^964`	assume	active	frontmostApp answers the app in front
`cairn^965`	assume	active	permission answers whether the app holds it, and prompts only when asked
`cairn^966`	assume	active	record streams the levels of exactly the samples it keeps, and nothing after its stop
`cairn^967`	assume	active	A clip's WAV for a range of windows holds exactly those samples
`cairn^968`	assume	active	globalKey reports the hotkey's press and release, and other keys while it is held
`cairn^969`	assume	active	typeText types exactly the text into that app, or nothing
`cairn^970`	assume	active	upload sends the body assembled from its parts, with the secret in its header
`cairn^971`	assume	retired	A secret is read from the environment or its file, and never shown
`cairn^972`	assume	active	The Keychain keeps what it was given for this app
`cairn^973`	assume	active	Captured reply fields go to the Keychain and never to Lean
`cairn^974`	assume	active	http sends the request as given, with its secret header, and returns the response as received
`cairn^975`	assume	active	An environment secret is read from the environment or its file, and never shown
`cairn^990`	assume	active	Wrapped lines paint as wide as Lean measured them
`cairn^991`	assume	active	Lean breaks lines where Core Text would
`cairn^1000`	assume	active	openItem opens exactly the URL or existing file it names
`cairn^1001`	assume	active	appRunning answers whether an app with that bundle id runs
`cairn^1002`	assume	active	readDefault answers the default's value as text
`cairn^1003`	assume	active	makeDir makes a private directory and its parents
`cairn^1004`	assume	active	A painter's pixels stay inside its box
`cairn^1005`	assume	active	record reports started once its microphone is running, before any audio, or fails without it
`cairn^1006`	assume	active	loadImage answers the image's pixel size, or the fault
`cairn^1007`	assume	active	An image's pixels stay inside its box
`cairn^1008`	assume	active	An image is drawn where its oriented pixels are
`cairn^1009`	assume	active	cancelRequest stops a running request's work; it is still answered once
`cairn^1010`	assume	active	The window is never smaller than the app's minimum size
`cairn^1011`	assume	active	The image cache reports every image it drops, after it is gone
`cairn^1020`	assume	active	Secure event input is on exactly while a secure field has focus