---
language: "en"
title: "Akno documentation"
canonical: "https://akno.tenphi.me/documentation/"
source: "docs/README.md"
version: "0.18.16"
index: true
---

# Akno documentation

![Akno logo](/_tasty-assets/a5fada983fda-akno.svg)

The root [README](/overview) is the short introduction. These guides explain the workflows and design in
more depth without making every reader carry the complete implementation history.

See [Folder-owned timelines](/folder-timelines) to give work, projects, or other folders independent histories.

## Start here

1. [Getting started](/getting-started) — install Akno, choose a setup, index, and run the first recall.
2. [The memory lifecycle](/memory-lifecycle) — see what humans, agents, and the dream cycle do to the files.
3. [Core concepts](/concepts) — understand pages, documents, roles, rules, citations, and result states.
4. [Reading memory](/reading) or [Writing and ingestion](/writing) — follow the workflow you need.
5. [The dream cycle](/dream-cycle) — understand maintenance before enabling scheduled writes.

## Reference and internals

* [Configuration](/configuration) — config layers, secrets, models, profiles, and folder rules.
* [Command reference](/commands) — purpose, write behavior, and model needs for every command.
* [How Akno works](/how-it-works) — indexing, retrieval, mutation, service, and recovery architecture.
* [Operations](/operations) — services, schedules, diagnostics, privacy, recovery, and platform constraints.
* [Benchmarks](/benchmarks) — reproducible quality gates and current qualified-model evidence.
* [Limitations](/limitations) — current capability boundaries and deliberate non-goals.

## Common paths

| Goal                              | Read                                                                                                                                            |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Understand everyday behavior      | [Memory lifecycle](/memory-lifecycle) → [Core concepts](/concepts)                                                                              |
| Try Akno safely                   | [Getting started](/getting-started) → [Memory lifecycle](/memory-lifecycle)                                                                     |
| Connect an agent host             | [Reading memory: automatic context](/reading#automatic-context-for-an-agent-host) → [Operations](/operations)                                   |
| Import existing files             | [Writing and ingestion](/writing#documents-and-ingestion) → [Core concepts](/concepts#pages-and-documents)                                      |
| Enable autonomous maintenance     | [Memory lifecycle](/memory-lifecycle#what-the-dream-cycle-does) → [Dream cycle](/dream-cycle)                                                   |
| Diagnose missing or slow behavior | [Operations](/operations#diagnostics) → [Benchmarks](/benchmarks)                                                                               |
| Change Akno itself                | [CONTRIBUTING.md](https://github.com/tenphi/akno/blob/main/CONTRIBUTING.md) and [AGENTS.md](https://github.com/tenphi/akno/blob/main/AGENTS.md) |