Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 Jun 10:26
v0.1.0
f473c47
This commit was signed with the committer’s verified signature.
brickpop Jør∂¡
SSH Key Fingerprint: zQsoy/MEmoYvKdyIUB8/5lSk2uf9+KseLVglKQlW0sw
Verified
Learn about vigilant mode.

The first release of wiki: a single static Go binary that turns a folder of Markdown into a queryable, link-aware knowledge
base. Zero runtime dependencies; native on macOS, Linux, and Windows/WSL.

A bundle is a directory marked by a wiki.toml file, with the Markdown content directly inside it; wiki walks up to find it,
the way git finds .git. Files stay the single source of truth, the index is derived and disposable, and the format is
aligned with the Open Knowledge Format.

Querying and reading

  • status — bundle and index summary (entries, links, tags, tasks, broken, orphans)
  • list / ls — list entries, filtered by --type, --tag, --prefix
  • read — print an entry's body with frontmatter stripped
  • outline — print an entry's heading hierarchy
  • search — case-insensitive full-text over frontmatter and body (--type/--tag/--prefix, grep-style --lines)
  • tasks — collect - [ ] checkboxes across the bundle (--all, --done, --prefix)
  • tags / properties / property — introspect the bundle's vocabulary (--counts, --sort=name|count, --prefix)

Link graph

  • links / backlinks — an entry's outgoing and incoming links
  • unresolved — links to entries that don't exist yet (the to-write list)
  • orphans — entries nothing links to

Mutating and maintaining

  • move / mv — relocate or rename an entry and rewrite every link to it (--dry-run), anchor-preserving, including relative
    links
  • tidy — canonicalize the bundle: --links (relative → root-absolute), --slug (spaced filenames → hyphenated), bare command
    previews
  • check — an opt-in conformance and health lint (missing/unknown type, broken links, depth, slug, okf_version drift,
    timestamp format); --fix repairs safe drift. Not an OKF gate
  • init — scaffold a fresh, check-clean bundle from an embedded starter (no network); --force for a non-empty dir

Across every command

  • Output formats: --format text|json|csv|tsv (csv/tsv derive columns from result field tags)
  • --root to operate on a bundle elsewhere (redirects discovery, no chdir)
  • Exit codes: 0 results, 1 no results, 2 error
  • Reserved filenames index.md / log.md carry no frontmatter; entry filenames are slugs
  • Hand-rolled, zero-dependency frontmatter/link/task/heading parsers (no full Markdown AST)
  • Full justfile, CI, smoke test, and goreleaser cross-compilation

Changelog

  • f6bb9f6 Adding CSV and TSV output formats
  • 56ec09c Adding draft to the type dictionary
  • e2cfff7 Adding support for WSL/Win
  • 2bbac90 Adding the read and outline commands
  • 5d05af0 Adding the tasks wiki
  • ff155b8 Adding wiki check --fix
  • 420ee85 Adding wiki init to scaffold bundles
  • a9108cf Adding wiki links and backlinks
  • 3c54590 Adding wiki move
  • b8e68d9 Adding wiki search
  • 9006882 Allowing to list tags and properties
  • 8b2a9f9 Allowing to specify the bundle root and clearer prefix usage
  • c1c1fad Consolidate relative links to root-absolute
  • 01d2407 Handling the OKF version mapping
  • f473c47 Improved main message
  • 22f80bb Improved readme
  • 6f16297 Improving the readme
  • c670d77 Initial commit
  • 9a8156c Internal hardening and coverage
  • a454751 Making agentic wiki OKF compliant
  • 5de2854 Minor rename
  • 7d6e168 Update README.md
  • 12e37f3 Wiki tidy: normalize links and slugify paths with spaces
Assets 9
Loading