Releases: agentic-wiki/wiki
Release list
v0.3.1
Fixed
wiki initnow works in a fresh git repo. A directory containing only a
.gitfolder is no longer treated as non-empty, sogit init && wiki init .
just works. Directories with real content still require--force, so the
guard against clobbering files is unchanged.
Docs
- README now tells Obsidian users to write standard markdown links (turn off
Use [[Wikilinks]], set New link format to Absolute path in vault).
wikidoes not recognize[[wikilinks]], so left on they silently drop out
of the graph.
Upgrade: brew upgrade agentic-wiki/tap/wiki, or
go install github.com/agentic-wiki/wiki/cmd/wiki@v0.3.1.
Changelog
v0.3.0
Install with Homebrew
wiki is now on Homebrew, for macOS and Linux alike:
brew install agentic-wiki/tap/wiki
Added
- Homebrew distribution. A single cross-platform formula covering
macOS and Linux on both arm64 and amd64, published automatically to the
agentic-wiki/homebrew-taptap on every release. Preview it locally with
just formula-preview.
Changelog
- 7de3edd Adding Homebrew as a release channel
v0.2.0
Adds dataset table extraction and timestamp sorting, and brings exit codes and check severity in line with the tools agents
already know (ls, grep, linters).
Added
wiki table <file>— extract a dataset's markdown table as text, csv, tsv, or json, so it pipes straight into jq, duckdb,
or an LLM. One clean table per file needs no flag; for a file with several,--n N(1-based) picks one, and the command lists
them rather than guessing.wiki list --sort=path|timestamp(with--reverse) — order entries by their curated frontmatter timestamp, falling back to
file mtime when it is absent. Newest-first by default; --reverse gives oldest-first, handy for a grooming pass.
Changed
- Exit codes now follow ls/grep/lint conventions. The enumeration and diagnostic commands (
list, tasks, tags, properties, property, links, backlinks, orphans, unresolved) exit0when they find nothing, the way ls of an empty directory succeeds
(previously they returned 1). Exit1now means a genuine "no match": search with no hits, table with no such table, and
check with conformance errors. Exit2remains a real error (no bundle, bad arguments, unreadable file).- Scripts heads-up: if you branched on exit 1 to detect "no results" from a query command, test the output instead (e.g.
[ -n "$(wiki unresolved)" ]). search keeps its grep-like 1 on no match.
- Scripts heads-up: if you branched on exit 1 to detect "no results" from a query command, test the output instead (e.g.
wiki check: a broken link is now a warning, not an error. A bundle that links to not-yet-written entries now passes check
(exit 0), matching the OKF view that an unresolved link is future knowledge, not malformed. Only a missing or invalid type
is still an error (exit 1). wiki unresolved remains the dedicated list of broken links.- CI heads-up: if you relied on check failing for broken links, it no longer does; gate on wiki unresolved being non-empty
instead.
- CI heads-up: if you relied on check failing for broken links, it no longer does; gate on wiki unresolved being non-empty
Changelog
v0.1.0
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