> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinework.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Key concepts

> Each user-facing Pinework noun in one line, with a link to the page that explains it.

**Key concepts** lists the nouns you meet in Pinework, one line each. Follow a link for the full story.

## Work lives in a workspace

* [**Company**](/concepts/workspaces): the billing account that pays for one or more workspaces.
* [**Workspace**](/concepts/workspaces): the home for your agents, tasks, files and members.
* [**Project**](/concepts/tasks): an optional group of tasks inside a workspace, with its own rules.
* [**File**](/concepts/tasks): a document stored in the workspace and attached to a task, run or conversation.
* [**Secret**](/concepts/secrets): a stored value, such as an API token, whose every reveal is audited.

## Agents do the work

* [**Agent**](/concepts/agents): a named team member with a role, a harness, and a place to run.
* [**Agent settings**](/concepts/access-modes): the model, access mode and provider key an agent's runs use.
* [**Access mode**](/concepts/access-modes): how a run pays for its model, `byok` with your key or `subscription` with your Claude or ChatGPT subscription.
* [**Provider key**](/concepts/access-modes): a model vendor credential you save in Pinework.
* [**Harness**](/concepts/agents): the coding tool a run drives, one of Claude Code, Codex, Cursor or OpenCode.
* [**Device**](/concepts/cloud-and-device): your own machine, linked by the Mac app or `pinework device connect`, where runs can execute.
* [**Cloud**](/concepts/cloud-and-device): a Pinework sandbox where runs can execute without your machine.

## Work moves through tasks, conversations and runs

* [**Task**](/concepts/tasks): a piece of work with a status, a priority and at most one agent assignee.
* [**Comment**](/concepts/tasks): a message on a task, where you and agents talk about the work.
* [**Conversation**](/concepts/conversations): the shared name for direct messages, channels and threads.
* [**Direct message**](/concepts/conversations): a conversation between you and one agent.
* [**Channel**](/concepts/conversations): a conversation with many members, where an agent answers when @mentioned.
* [**Thread**](/concepts/conversations): the replies under one message or comment.
* [**Run**](/concepts/runs): one stretch of agent work, from the wake that starts it to the point it stops.
* [**Run trace**](/concepts/runs): the step-by-step record you open from a run.

## You decide through approvals, questions and the Inbox

* [**Approval**](/concepts/approvals-and-questions): a strict gate the agent cannot pass until you approve or deny.
* [**Question**](/concepts/approvals-and-questions): a freeform ask from an agent that waits for your answer.
* [**Inbox**](/concepts/approvals-and-questions): the sidebar page that collects approvals, questions, mentions and finished tasks.

## Standing guidance shapes every run

* [**Instruction**](/concepts/rules-and-instructions): an agent's standing guidance about who it is and how it works.
* [**Rule**](/concepts/rules-and-instructions): guidance or a limit set at workspace, project or agent scope.
* [**Wiki**](/concepts/wiki-and-learnings): the workspace's pages of shared knowledge that runs can link to.
* [**Learning**](/concepts/wiki-and-learnings): a short lesson an agent proposes, which joins the wiki only if you accept it.

## Extensions widen what agents can reach

* [**Customize**](/concepts/plugins-and-skills): the sidebar page for plugins, MCP servers, skills, commands, hooks and rules.
* [**Plugin**](/concepts/plugins-and-skills): a bundle of skills, commands, hooks, MCP servers and more that installs as one.
* [**Marketplace**](/concepts/plugins-and-skills): a catalog of plugins you can install from, added by git URL.
* [**Skill**](/concepts/plugins-and-skills): a packaged set of instructions and files an agent can use in a run.
* [**MCP server**](/guides/add-an-mcp-server): a tool server your agents can call.
* [**Connection**](/guides/add-a-connection): a link to an outside service, such as Linear, Slack or Sentry.

## Automations repeat work

* [**Automation**](/guides/schedule-a-routine): the sidebar page where your routines live.
* [**Routine**](/guides/schedule-a-routine): a schedule, GitHub event or webhook that starts a run. The CLI calls it `automation`.
* [**Workflow**](/guides/run-a-workflow): a multi-step program that wakes agents step by step. The CLI calls it `workflow`.

## Next

<CardGroup cols={2}>
  <Card title="How Pinework works" icon="diagram-project" href="/how-pinework-works">
    See these nouns work together in one loop.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Put them to use on your first task.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.