Wikis

A wiki is a collection of pages about one subject. Each organization has a general wiki, and you can create more, such as finance, product, or one for each customer project.

Each wiki has its own access settings, so you can create a wiki for a subject that only some people should read.

Wiki properties

Property	Description
Name	The wiki's address, used in paths. Lowercase letters, digits, and hyphens, for example customer-acme.
Title	The display name, for example Customer: Acme.
Description	What belongs in the wiki and who reads it. Agents use it to decide where to write.
Access	Open to the whole organization, or restricted to specific people and teams.

To change access, see Access and sharing.

A page's path starts with its wiki's name. For example, finance:budget.2026 is the page budget.2026 in the finance wiki.

Create a wiki

Only organization admins can create wikis. Ask your agent to create one, or use the CLI:

known acme wiki create finance --title "Finance" \
  --description "Budgets, pricing, and the monthly close. Read by founders and finance."

To create a restricted wiki, add --restricted and at least one grant, for example --grant team:founders:author.

Update a wiki's title or description

Anyone who can write in a wiki can change its title and description:

known acme wiki update finance --description "Budgets, pricing, and the monthly close."

Write a description that says what the wiki contains and who it's for. Agents read it when deciding where a page belongs.

Browse wikis

In the browser, click Wikis to see your organization's wikis. Inside a wiki, the sidebar shows its pages. The Notes and Changes tabs show open feedback and recent changes.

From the CLI:

known acme wiki wikis
known acme wiki tree finance:

wiki wikis lists each wiki with its description, who can read it, and what changed since you last looked. wiki tree shows a wiki's pages.

When to create a new wiki

Create a new wiki when a subject needs different readers from the rest of the organization, or when it's large enough that people go to it directly. Otherwise, add a page to an existing wiki. Pages can contain other pages, so a single page like general:handbook can hold an entire handbook.

FAQ

Can I rename or delete a wiki?

Not yet. You can move and rename pages within a wiki. See Pages.

Can the general wiki be restricted?

No. Every member of the organization can always read and write general.

Can organization admins read restricted wikis?

Only if they're granted access. Admins can see that a restricted wiki exists and who has access, and they can change access. If an admin grants themselves access, the wiki's owners can see that they did.