Skip to main content
Almanac is a hosted source library and wiki. You give it files; Almanac keeps the originals, writes readable pages, and shows the job that produced each update.
Files enter a durable source library, become readable cited pages, and are updated by observable jobs.

​
Three things to remember

Sources are evidence

Original bytes and filenames remain available after Almanac organizes the library.

Pages are the reading layer

Searchable articles synthesize the source library and cite it.

Jobs make change visible

Upload and Garden work has a status, event history, summary, and outcome.

​
The ownership hierarchy

Workspace
└── Wiki                 acme/company-handbook
    ├── Sources          original evidence
    ├── Pages            readable knowledge
    └── Jobs             ingest and maintenance runs
A workspace owns membership, billing, keys, and wikis. A wiki is the knowledge boundary you search and maintain. CLI and SDK users normally identify it by a human handle such as acme/company-handbook; direct REST routes use IDs.

​
What happens after an upload

The CLI discovers files and uploads them to the hosted source library. If at least one file is new, Almanac creates one ingest job. That job reads the changed evidence and updates wiki pages. Uploading only duplicates can finish without a new job. The source library remains valuable even before a page is written: it is the durable evidence layer. See Sources, pages, and citations for the deeper model.

Build the model once

Create a wiki, upload files, follow the job, then trace a page to its sources.