{"schemaVersion":"opencli.cli.v1","slug":"zk","name":"zk","shortName":"zk","binaryName":"zk","maker":{"slug":"zk-org","name":"zk","type":"org","url":"https://github.com/zk-org","officialPlatformMaker":false,"featuredBuilder":false},"category":"Productivity","description":"Notes search, zettelkasten, and knowledge base from the terminal. Built by zk. Supports structured output — good for scripts and agents. Runs entirely on your machine.","tagline":"Notes search, zettelkasten, and knowledge base from the terminal.","install":{"packageManager":"brew","command":"brew install zk","packageName":null,"npmPackage":null,"brewFormula":null,"brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"zk --version","signal":"zk responds locally and is ready for the first real command."},"quickStart":"zk list --format json","exampleWorkflow":["zk list --format json"],"agent":{"readiness":{"label":"Great for agents","score":70,"reasons":["Structured output is available for parsing.","Supports non-interactive/scripted use.","Can run locally with less credential exposure."],"guardrails":["Network access is required; avoid leaking secrets in logs.","Start read-only, then ask before mutations."]},"packUrl":"https://opencli.co/cli/zk/agent.md","packMarkdown":"# OpenCLI Agent Pack: zk\n\nUse this when an AI agent needs to work with `zk`.\n\n## What this CLI is for\nNotes search, zettelkasten, and knowledge base from the terminal. Built by zk. Supports structured output — good for scripts and agents. Runs entirely on your machine.\n\nBest for: notes search, zettelkasten, and knowledge base from the terminal.\n\n## Agent readiness\nGreat for agents (70/100)\n- Structured output is available for parsing.\n- Supports non-interactive/scripted use.\n- Can run locally with less credential exposure.\n\n## Install\n```sh\nbrew install zk\n```\n\n## Verify before real work\n```sh\nzk --version\n```\nExpected signal: zk responds locally and is ready for the first real command.\n\n## Safe starting commands\n```sh\nzk --version\n```\n\n```sh\nzk list --format json\n```\n\n## Guardrails for agents\n- Network access is required; avoid leaking secrets in logs.\n- Start read-only, then ask before mutations.\n\n## Suggested agent instruction\nYou may use zk (`zk`) for notes search, zettelkasten, and knowledge base from the terminal.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.\n\nSource: OpenCLI\n"},"fit":{"bestFor":"notes search, zettelkasten, and knowledge base from the terminal.","useThisIf":"You want productivity workflows that runs entirely on your machine.","skipIf":"You don't work with productivity workflows.","whatHappensNext":"Run `zk list --format json` and see what comes back."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":true,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":false,"requiresNetwork":true,"ciFriendly":false,"localFirst":true,"destructivePotential":"medium"},"taxonomy":{"useCases":["Notes search","Zettelkasten","Knowledge base"],"aliases":[],"keywords":["notes","markdown","pkm","zettelkasten"],"tags":[]},"links":{"website":"https://github.com/zk-org/zk","github":"https://github.com/zk-org/zk","docs":"https://github.com/zk-org/zk/blob/main/docs","opencli":"https://opencli.co/cli/zk","markdown":"https://opencli.co/cli/zk/agent.md","json":"https://opencli.co/cli/zk.json"},"metrics":{"githubStars":2640,"latestRelease":"2026-06-08T10:56:33Z","license":"GPL-3.0","metricLabel":"Homebrew installs (30d)","metricValue":165,"metricSource":"homebrew","metricAsOf":"2026-06-08T11:01:02.303Z"}}