# User Guide

ztlctl's User Guide is for knowledge workers building personal knowledge systems — whether you're a researcher, writer, product manager, or student. These guides show you how to think in zettelkasten, capture ideas, build connections, and retrieve knowledge on demand.

**Not sure where to start?** Try the [Quick Start](../quickstart.md) or the [Tutorial](../tutorial.md).

## In This Guide

| Page | What it covers |
|------|----------------|
| [Tutorial](../tutorial.md) | Hands-on walkthrough: create notes, link them, run a session |
| [Core Concepts](../concepts.md) | Content types, lifecycle states, and vault structure |
| [Knowledge Paradigms](../paradigms.md) | Second-brain vs knowledge garden — which fits your workflow |
| [Obsidian Starter Kit](../obsidian.md) | Set up Obsidian as a visual frontend for your vault |
| [Built-in Plugins](../plugins.md) | Git and Reweave plugin guides — config, triggers, and scenarios |
| [Agentic Workflows](../agentic-workflows.md) | Orchestrate AI agents with ztlctl as their note substrate |
| [Command Reference](../commands.md) | Every CLI command and flag |
| [Configuration](../configuration.md) | Config file options, vault settings, and environment variables |
| [Troubleshooting](../troubleshooting.md) | Common problems and solutions |
