LinkLore

add(type='lore'|'doc', title, msg=) — lore=journal entry/decision, doc=spec/plan. 2 linking args: links=unified (code files·dc/lr id·title auto-classified, flow=True for a doc chain) · push_to=send to a box (not a link). items=['a','b']→checklist(0/N, doc only) · items=[{...}]→batch creation(both lore·doc — use this for bulk, quieter nudges than N single calls, with status='rule' as the same reserved value in each dict; each dict may set its own 'type' to mix lore·doc in one call — omitted entries inherit the top-level type=). details help=True

project dashboard — call at the start of every session. external source 🔔 = a new push has arrived. receive it with openbox(action='show'). options: dismiss(turn off a nudge), undismiss(restore it), help.

[read-only] cleanup(type='lore'|'doc') threshold(=0.85), status(=open), help - duplicate candidates.

Project settings (openbox source options) + iam + session pin. WARNING: handle/name/email apply machine-wide, not per-project. Sharing lives in a separate tool: openbox (openbox sharing/members). 11 actions: - action='whoami' → your identity (handle/name/email) - action='version' → server code version (git commit) - action='sources' → list registered external sources (openboxes) - action='option' → change an external source's settings (auto_search=/show_prefix=) - action='sync' → force-refresh an external source's cache - action='forget' → deregister an external source - action='pin' → pin this session to a specific project - action='unpin' → unpin the session - action='sessions' → list/revoke your account sessions (revoke=) - action='projects' → list every LinkLore project on this machine - action='delete_project' → permanently delete your personal-server copy of this project (returns guidance, no execution — use the forced() command it prints) help=true for details.

[read-only] doc_flow(id) — renders a doc's flowLink chain in order (journey view).

[read-only] doc_map(oneline) — overview of the full doc link network.

[read-only] doc_rollup(id) — find and collect lore linked to a doc into an AI-summary draft.

doctor() - checks project data integrity (oldId/newId, files[] paths, link targets). doctor() read-only diagnostics (default) doctor(action='fix') automatically repairs any issues found

edit(id, action=, ...) — 4 write modes (action). If action is omitted, defaults to append (msg alone works too). Write modes (action, tool option = behavior match): - **append (default, non-destructive)** → edit(id, action='append', msg='new content') # or omit action, msg alone — appends to the end of body, keeps the rest - **section (partial edit)** → edit(id, action='section', section='heading', msg='new section content') # replaces just that section (existing heading only — errors if missing; to add a new section use append), keeps the rest - **overwrite (full body)** → edit(id, action='overwrite', msg='new body' [, tags=[...], ...]) # old body kept in history(recoverable via log). tags/items(doc only) and links= file-paths are overwritten too; links= ids (lr-/dc-) are always additive, never removed by overwrite - **supersede (follow-up publish)** → edit(id, action='supersede', msg='new conclusion') # creates a new id, old one head=False (action= is one of append|section|overwrite|supersede|remove. Unspecified('') means append.) Other: - remove a checklist item(doc only) → edit(id, action='remove', items=[N]) # 1-based, multiple: items=[N,M] - mark as dropped → edit(id, status='dropped') (still shown in search) - supersede chain (keep old + new head) → edit(id, action='supersede', ...) (or add(type='lore'|'doc', relates=old_id, ...)) - supersede by an existing item (reconcile a contradiction) → link(a=X, b='lr-Y'|'dc-Y', action='supersede') (X→head=False) - permanent delete → rm(id)

Executes the exact destructive action described in a warning printed by rm(), local_cross(), config(), or openbox() — copy the values from that warning verbatim. Do not call this on your own initiative; only call it after seeing a warning that names it and tells you exactly what to pass.

init(blueprint='') — set up .linklore in this directory (starts local footprint memory). - init() basic setup - init(blueprint='X') apply a blueprint project_dir: set up .linklore in another folder (creating a boundary is init-only). setting up there doesn't change this session's base project — to keep working there, config(action='pin').

link(a, b, action=) — connect two items (dc↔dc / lr↔lr / dc↔lr auto-detected, prefix matching OK). a/b may also be a file path or an existing title — non-id-shaped values are auto-classified (same as links= in add/edit). Undo (inverse) = unlink(a, b) — same arguments. action has 5 modes (extends the member/config(action=) convention): - action='related' (default, same if omitted) → mutual link (symmetric). Same as link(a, b) — dc↔dc/lr↔lr/dc↔lr - action='flow' → not a mutual link but **document order** (a→b direction, doc↔doc only): read a, then b. - action='supersede' → "a is replaced by b" — a=old (dropped, head=False/dropped), b=target (alive, must be an existing item — none is created). lore↔lore or doc↔doc only. - action='unrelated' → verdict: not related — this pair stops appearing as related candidates or duplicate alerts (not a link, a stored verdict). - action='distinct' → verdict: not a duplicate (confirmed separate) — only duplicate alerts are silenced, it still appears as a related candidate. The 4 suggestion verdicts: related-yes=link(a,b) · duplicate-yes=action='supersede' · related-no=action='unrelated' · duplicate-no=action='distinct'

Use this when you want to view, move, or copy lore/doc items that live in a different project or folder (workspace) — cross-project / workspace access. local_cross(action, id, to='workspace-path', from_dir='') — directly operate on another LinkLore project on the same disk (works on both lore and doc). action='move' move to another workspace (source deleted, id preserved; createdAt/files/tags/level/status/body/items preserved; provenance recorded) action='copy' copy to another workspace (source kept, a new id is issued + provenance recorded — re-copying the same original is an idempotent skip) action='show' view another workspace's content (read-only — query/tag/type/status passed through) from_dir= applies to all three actions — for move/copy it sets the source workspace (default: cwd); for show it is the lookup target, hence required. ⚠️ move always previews first, regardless of item count (it deletes the source, so there's no low-risk single-item case) — confirm and run it via the forced(...) call the preview prints, no stored slot. copy is reversible (source kept), so a single item still runs immediately; only 2+ items preview first, confirmed the same way. cf. sharing across a server/team goes through openbox(), not local_cross() — this tool never talks to a backend, it only works within your own disk. ⚠️ only between projects you own — if the target is genuinely someone else's/another team's, don't use local_cross() just because you have filesystem access; go through openbox('push') (the recipient must openbox('pull') — a review gate).

[read-only] log(id) — shows the edit-history timeline (who changed what, when). No id = project-wide history. For current content use show(); for code<->doc drift use status(). period('Nh' hours|'Nd' days|'YYYY-MM-DD' UTC|'YYYY-MM-DD..YYYY-MM-DD' range), sort=oldest, max, plumbing: help

Browse and pull free lore/doc from LinkLore's public curated catalog — no account needed. market(query=, id=, filter=, order=, max=) — default (no action=) searches/browses: id= alone shows a single listing's detail, query=/filter=/order=/max= search the catalog. action='pull' with id= fetches that listing into this project. Buy lore. Pull it into your project.

openbox(name, action) — the owner wall: every exchange with other owners (share, absorb, membership) goes through this single gate. An openbox is an invite-only shared box. Your own server backup is push()/pull() (no target argument — never crosses the wall). Moving or copying into another LOCAL project you also own (same disk, no server round-trip) goes through local_cross(), not openbox — lighter and faster when ownership isn't in question. transport: - openbox(name='team-prj', action='push', id='lr-x') share footprints to the box — sends copies, your project unchanged. 2+ ids: preview first, re-call with forced(action='openbox', push=...) - openbox(name='team-prj', action='pull', id='lr-x') absorb the box's footprints into your project — new id + provenance - openbox(name='team-prj', action='rm', id='lr-x') remove what I shared from the box (your project unchanged) browse: - openbox(name='team-prj', action='show', query='auth') browse the box — cache auto-refreshes on call (filters: query·tag·max·oneline) governance: - openbox(name='team-prj', action='new', display_name='me') create a box (you = owner) - openbox(name='team-prj', action='edit', description='...') update the box description (owner/member) · title=box name(owner only) · display_name=your nickname(anyone) - openbox(name='team-prj', action='invite', role='member') invite code (owner). kind='project' = project member, member='<nickname>' = reissue - openbox(action='join', code='X', display_name='me') join with an invite code (box name = backend project name, no local alias) - openbox(name='team-prj', action='docking') dock a membership to this project by name — 2+ boxes with the name: candidates + project_id='prj-...' confirm. project-kind cannot dock - openbox(name='team-prj', action='undocking') remove only this project's wiring — server membership unchanged (leaving is leave) - 'list' members · 'role' member=+role= · 'transfer' member= (double confirm) · 'leave' (double confirm) · 'rm' member='<nickname/email>' to expel a member (owner) · 'delete' whole box (owner, double confirm) (member= refers to members by nickname or email — no ids. action grammar: sustained-connection procedures = -ing (docking/undocking), immediate commands = bare verb. rm(id=)=take back a shared entry, rm(member=)=expel a member — exactly one)

[my server] pull(id) — restore the home base from my server (works across devices too). Like git pull: server → local. Bringing things from an openbox is openbox(action='pull'), not pull — pull is for my server only. If local is newer/same it's skipped; a real conflict (both sides changed) is shown separately (local kept). - pull() my whole server → home base - pull(id='lr-x'|'dc-x') restore a selection (moving items between local workspaces is local_cross(), not pull())

[my server] push(id) — upload the home base to **my server** (visible to me only). Like git push: local → server. Not for sharing — sharing to others (an openbox) is openbox(action='push'), not push (push has no target argument by design, so it cannot share). - push() the whole home base → server - push(id='lr-x'|'dc-x') a single item - push(id=['lr-x','dc-y']) a batch Take down (inverse): rm(sent='lr-x'|'dc-x') — removes my server copy only, home base untouched. (moving items between local workspaces is local_cross(), not push())

report(msg) — send feedback/a bug straight to the LinkLore team. Works whether or not you're logged in (if logged in, your iam is attached automatically — never forced).

restore(id) — recover trashed lore/doc. no id lists the trash.

rm — unified delete for my own project. Target is chosen by argument (action= is an explicit alternative, auto-detected by which argument is present when omitted). show/rm stay inside my own project — openbox (shared) cleanup lives in the openbox tool. ## Deleting items (lore/doc) — id is a single value or a list (batch) - **trash (recoverable, default)** → `rm(id)` → restore(id) to recover - **permanent delete (unrecoverable)** → `rm(id, force=True)` prints the exact `forced(action='rm', id=...)` call to run — this call itself deletes nothing - **batch delete** → `rm(id=['lr-x','dc-y'], force=True)` - **mark as dropped (stays in search)** → `edit(id, status='dropped')` - **supersede (keep old + new head)** → `add(type='lore'|'doc', relates=old_id, ...)` ## Taking down something you sent — my server only (reverse of push, doesn't touch the source of truth) - `rm(sent='lr-x'|'dc-x')` take down from my server (or action='sent' explicitly) ## Openbox things don't live here (moved behind the openbox gate) - remove a shared entry from the box: openbox(action='rm', id=...) · expel a member: openbox(action='rm', member=...) · delete an openbox: openbox(action='delete')

[read-only] show() — search or find lore/doc. target/scope: query·type / filters: tag·status·file·period('Nh' hours|'Nd' days|'YYYY-MM-DD' UTC|'YYYY-MM-DD..YYYY-MM-DD' range)·source_id / result shape: sort·max·oneline·superseded / mode: action / plumbing: help. Before editing code, check file=path for related lore/doc — a direct Edit/Write auto-surfaces this via a PreToolUse hook, but check it yourself before delegating. show/rm stay inside my own project — to browse an openbox, use openbox(action='show')

status() — detects code↔doc sync drift (git-diff based). Not for reading lore/doc content → use show()/brief(). since, action(''|'ack'|'reset'), ack, reset, help.

unlink(a, b, action=) — disconnect two items or clear a verdict. Symmetric with link() (action='' default|'flow'|'unrelated'|'distinct', also accepts file paths the same way).