# ztlctl

> A local knowledge operating system for human users and AI agents.
> Zettelkasten-based CLI and MCP tool for building personal knowledge graphs — capture, link, query, and surface knowledge from a local SQLite vault.

## Getting Started

- [Home](https://thatdevstudio.github.io/ztlctl/): Landing page and project overview
- [Installation](https://thatdevstudio.github.io/ztlctl/installation/): Install via pip, uv, or Homebrew
- [Quick Start](https://thatdevstudio.github.io/ztlctl/quickstart/): Your first vault in under 5 minutes

## User Guide

- [User Guide](https://thatdevstudio.github.io/ztlctl/guide/): User Guide section overview and navigation
- [Tutorial](https://thatdevstudio.github.io/ztlctl/tutorial/): Hands-on walkthrough: create notes, link them, run a session
- [Core Concepts](https://thatdevstudio.github.io/ztlctl/concepts/): Content types, lifecycle states, and vault structure
- [Knowledge Paradigms](https://thatdevstudio.github.io/ztlctl/paradigms/): Second-brain vs knowledge garden — which fits your workflow
- [Obsidian Starter Kit](https://thatdevstudio.github.io/ztlctl/obsidian/): Set up Obsidian as a visual frontend for your vault
- [Built-in Plugins](https://thatdevstudio.github.io/ztlctl/plugins/): Git and Reweave built-in plugin guides — config fields, trigger conditions, and common scenarios
- [Agentic Workflows](https://thatdevstudio.github.io/ztlctl/agentic-workflows/): Orchestrate AI agents with ztlctl as their note substrate
- [Command Reference](https://thatdevstudio.github.io/ztlctl/commands/): Every CLI command and flag
- [Configuration](https://thatdevstudio.github.io/ztlctl/configuration/): Config file options, vault settings, and environment variables
- [Troubleshooting](https://thatdevstudio.github.io/ztlctl/troubleshooting/): Common problems and solutions
- [Best Practices](https://thatdevstudio.github.io/ztlctl/best-practices/): Opinionated anti-patterns and correct patterns for vault, notes, tags, sessions, and agent workflows

## Developer Guide

- [Developer Guide](https://thatdevstudio.github.io/ztlctl/dev/): Developer Guide section overview and navigation
- [Contributing](https://thatdevstudio.github.io/ztlctl/development/): Architecture overview, branch workflow, and contribution process
- [Plugin Authoring](https://thatdevstudio.github.io/ztlctl/plugin-guide/): Tutorial and hookspec reference for building ztlctl plugins
- [API Reference](https://thatdevstudio.github.io/ztlctl/api-reference/): Auto-generated API reference for plugin contracts, hookspecs, and the ActionRegistry
- [MCP Server](https://thatdevstudio.github.io/ztlctl/mcp/): MCP tools, resources, prompts, and agent integration patterns
- [Agent System Manual](https://thatdevstudio.github.io/ztlctl/agents/): Machine-readable schemas, state machines, constraint rules, and interaction flows for LLM systems
