# Siftable

> AI-native workspace and context layer from ExecuFunction. Siftable gives people
> and agents shared access to tasks, calendar, knowledge, people, code context,
> code memory, documents, vault, and persistent workspace memory through MCP
> (Model Context Protocol), CLI, and REST API interfaces.

- [For Agents](https://siftable.io/agents.html): Siftable gives your agent a workspace: real tasks, calendar, projects, code, and memory as structured, queryable state.
- [Docs](https://siftable.io/docs.html): MCP setup, CLI installation, authentication, tool domains, workflows, and API reference.
- [Pricing](https://siftable.io/pricing.html): Free includes 200 credits/month; paid plans add larger monthly credit pools and expanded model access.

> **Access scopes:** Each PAT is domain-scoped. A calendar-only token cannot read tasks or vault secrets. Request only the scopes your agent needs.

## Getting Started
- [MCP Quickstart](https://siftable.io/docs.html#quickstart): 3-step setup: get PAT, configure MCP, verify
- [CLI Installation](https://siftable.io/docs.html#cli-install): `npm i -g @siftable/cli`, device flow auth, first command
- [Authentication](https://siftable.io/docs.html#authentication): Device flow (CLI) or PAT (MCP/API)
- [MCP Connection](https://siftable.io/docs.html#connection): SSE endpoint, compatible clients

## Tool Domains (MCP + CLI)
Each domain is accessible via MCP tools, CLI commands, and REST API. Full reference at docs.html. The primary CLI command is `sift`; `siftable` and `exf` are compatibility aliases.
- [Tasks](https://siftable.io/docs.html#tasks): MCP `task_list` / CLI `sift tasks list` — CRUD, status, priority, project filters
- [Calendar](https://siftable.io/docs.html#calendar): MCP `calendar_list_events` / CLI `sift calendar list` — events by date range
- [Projects](https://siftable.io/docs.html#projects): MCP `project_get_context` / CLI `sift projects context` — full project overview
- [Knowledge](https://siftable.io/docs.html#knowledge): MCP `note_search` / CLI `sift notes search` — notes, concepts, meetings, references
- [People](https://siftable.io/docs.html#people): MCP `people_search` / CLI `sift people search` — contact search
- [Codebase](https://siftable.io/docs.html#codebase): MCP `codebase_search` / CLI `sift codebase search` — semantic code search, git history, blame
- [Code Memory](https://siftable.io/docs.html#code-memory): MCP `code_memory_store` / CLI `sift code memory store` — persistent codebase facts
- [Documents](https://siftable.io/docs.html#documents): MCP `upload_document` / CLI `sift documents upload` — PDF, markdown, text
- [Vault](https://siftable.io/docs.html#vault): MCP `vault_create` / CLI `sift vault create` — encrypted secret storage

### Example: task_list response
```json
{
  "tasks": [
    {
      "id": "a1b2c3d4-...",
      "title": "Review PR #42",
      "status": "next_action",
      "priority": "do_now",
      "projectId": "e5f6a7b8-...",
      "dueAt": "2026-02-27T17:00:00.000Z",
      "createdAt": "2026-02-26T10:00:00.000Z",
      "subtaskCount": 2
    }
  ],
  "nextCursor": "eyJjcmVhdGVkQXQiOi..."
}
```

### Example Workflow: Link Code to a Task
1. `sift tasks create --title "Refactor auth module"` or MCP `task_create` creates the task.
2. `sift codebase register --root .` or MCP `codebase_register` registers the repo.
3. `task_link_code` links the task to the repo with file path and commit SHA.
4. `code_memory_store` stores durable context, such as "Auth module uses OAuth2 + PKCE."

## Concepts
- [Workflows](https://siftable.io/docs.html#workflows): Cross-domain recipes — link code to tasks, project onboarding, end-of-day review
- [Credits & Billing](https://siftable.io/docs.html#credits): Credit-based AI usage with monthly plan credits and optional packs
- [Idempotency](https://siftable.io/docs.html#idempotency): Mutations accept idempotency keys for safe retries
- [Permissions](https://siftable.io/docs.html#permissions): Domain-scoped tokens — calendar-only tokens can't touch tasks

## Product
- [Pricing](https://siftable.io/pricing.html): Free tier with 200 credits/month, plus paid plans and credit packs
- [Features](https://siftable.io/features.html): Tasks, calendar, assistant, knowledge, people, code context, memory, documents, and vault

## Optional
- [About](https://siftable.io/about.html): Company background
- [ADHD Focus](https://siftable.io/focus.html): How Siftable supports fast-brain workflows