# Known docs

> Known is a shared workspace of wikis and structured records for your company, used by your team and its AI agents.

## Getting started

- [Introduction](https://known.info/docs/index.md): Known is a shared workspace of wikis and structured records for your company, used by your team and its AI agents.
- [Quick start](https://known.info/docs/quick-start.md): Create an organization, add your first page, and connect an AI assistant.
- [Connect an agent](https://known.info/docs/connect-agent.md): Connect Claude, ChatGPT, or another MCP client to Known, and learn what connected agents can do.
- [Use Known in Claude](https://known.info/docs/connect-agent/claude.md): Connect Known to Claude so you can ask about your company's wikis and have Claude record decisions for you. This takes about 2 minutes and works on claude.ai and Claude Desktop.
- [Use Known in ChatGPT](https://known.info/docs/connect-agent/chatgpt.md): Connect Known to ChatGPT so you can ask about your company's wikis and have ChatGPT record decisions for you. This takes about 3 minutes.
- [Use Known in Claude Code](https://known.info/docs/connect-agent/claude-code.md): Connect Known to Claude Code so it can read your company's wikis in every project and record the decisions you make. This takes about 2 minutes.
- [Use Known in Codex](https://known.info/docs/connect-agent/codex.md): Connect Known to Codex so it can read your company's wikis and record the decisions you make. This takes about 2 minutes.
- [Use Known in Cursor](https://known.info/docs/connect-agent/cursor.md): Connect Known to Cursor so its agent can read your company's wikis and record the decisions you make. This takes about 2 minutes.
- [Use Known in VS Code](https://known.info/docs/connect-agent/vs-code.md): Connect Known to GitHub Copilot in VS Code so its agent can read your company's wikis and record the decisions you make. This takes about 2 minutes.

## Wikis and pages

- [Wikis](https://known.info/docs/wikis.md): Create wikis, describe what belongs in them, and decide when a subject needs its own wiki.
- [Pages](https://known.info/docs/pages.md): Create, edit, embed, move, and delete pages, and avoid overwriting other people's changes.
- [Links](https://known.info/docs/links.md): Link to pages and records, see what links to a page, and find broken links.
- [History](https://known.info/docs/history.md): See every revision of a page, who made each change, and how a page looked in the past.
- [Notes](https://known.info/docs/notes.md): Leave feedback on a page and resolve it once the page is updated.
- [Search](https://known.info/docs/search.md): Search pages and table records from the browser, an agent, or the CLI.

## Records

- [Records](https://known.info/docs/records.md): Store structured data on a page as a table or a log, and read and write it.
- [Schemas and retention](https://known.info/docs/schemas.md): Validate records with JSON Schema and control how long records are kept.

## Agents

- [Agents](https://known.info/docs/agents.md): Connect agents, control what they can access, and see the changes they make.
- [The Known assistant](https://known.info/docs/assistant.md): Ask questions and update wikis from Chat in the browser.
- [Use Known by voice](https://known.info/docs/voice.md): Talk to Known through ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code, or your computer's dictation.
- [The known CLI](https://known.info/docs/cli.md): Read and write Known from the terminal: sessions, project setup, pages, records, and notes.

## Organizations and access

- [Organizations](https://known.info/docs/organizations.md): Create an organization, switch between organizations, and understand roles.
- [Members and teams](https://known.info/docs/members.md): Invite members, verify your domain, set up single sign-on, and create teams.
- [Access and sharing](https://known.info/docs/access.md): Restrict a wiki, grant access levels, and share a wiki with another organization.
- [Plans and limits](https://known.info/docs/plans.md): What each plan includes, who is counted, and Known's limits.

## Build on Known

- [Sites](https://known.info/docs/sites.md): Build an app that signs people in with Known and reads your wikis.
- [Docs for agents](https://known.info/docs/for-agents.md): Get any docs page as Markdown, and point an agent at llms.txt.

## Guides

- [Guides](https://known.info/docs/guides.md): Guides to giving agents your company's context, organised by the problem you have: what goes wrong, every way of solving it, and how to do it with Known.
- [Comparisons](https://known.info/docs/guides/decisions.md): How Known compares with Linear, Jira, HubSpot and Attio, and where each is the better choice.
- [Known vs Attio](https://known.info/docs/guides/decisions/known-vs-attio.md): Attio is a configurable CRM with inbox sync and enrichment; Known keeps relationships with the rest of your work. When to choose each, side by side.
- [Known vs HubSpot](https://known.info/docs/guides/decisions/known-vs-hubspot.md): HubSpot is a CRM platform with inbox sync and agents; Known keeps relationships with the rest of your work. When to choose each, side by side.
- [Known vs Jira](https://known.info/docs/guides/decisions/known-vs-jira.md): Jira is a configurable tracker for teams at scale; Known keeps issues with their context. When to choose each, side by side, and how to use both.
- [Known vs Linear](https://known.info/docs/guides/decisions/known-vs-linear.md): Linear is a fast issue tracker for software teams; Known keeps issues with their context. When to choose each, side by side, and how to use both.
- [How-to guides](https://known.info/docs/guides/how-to.md): Step-by-step guides for setting up and running work in Known, with people and agents.
- [Set up a CRM in Known](https://known.info/docs/guides/how-to/crm.md): Set up a CRM your team and agents keep together: contacts and organizations once, interactions, and a pipeline, with the rules that keep records clean.
- [Set up issue tracking in Known](https://known.info/docs/guides/how-to/issue-tracking.md): Set up an issues table your team and agents share: a schema with links, rules on the page, and how to read it. About 15 minutes.
- [How your team and agents work issues in Known](https://known.info/docs/guides/how-to/issues-with-agents.md): How people and agents file, update and close issues in Known without overwriting each other, with examples from Known's own backlog.
- [Log a meeting to your CRM from ChatGPT, by voice](https://known.info/docs/guides/how-to/log-meetings-by-voice.md): Tell ChatGPT what happened in a meeting, out loud, and have it written to your CRM in Known as linked records.
- [Problems](https://known.info/docs/guides/problems.md): The problems teams hit when they put agents to work, each explained with every way of solving it.
- [Work your agents can see](https://known.info/docs/guides/problems/work-with-context.md): Issues and customers sit in tools that hold the ticket or the contact, while the reasons live elsewhere. Why it happens, the ways to solve it, and where Known fits.

## Writing

- [Writing](https://known.info/docs/writing.md): Essays, field notes and the changelog from the Known team: what we learn running a company on Known, with agents.
- [How we run our backlog and our fundraise on Known](https://known.info/docs/writing/running-on-known.md): Two founders, a handful of agents, and no issue tracker or CRM: what's in our records, what went wrong, and the rules that fixed it.