# Granary Setup

> Set up granary in a new project. Use when asked to initialize granary, install it, or get started with task management.

- Skill: `speakeasy-api/granary-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add speakeasy-api/granary-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/speakeasy-api/granary-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: speakeasy-api (https://skillmd.com/u/speakeasy-api)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/speakeasy-api/granary-setup

---


# Setting Up Granary

Use this skill when the user asks you to set up granary in their project.

## 1. Check Installation

First, verify granary is installed:

```bash
which granary
```

If not installed, direct the user to install it:

```bash
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/speakeasy-api/granary/main/scripts/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/speakeasy-api/granary/main/scripts/install.ps1 | iex
```

## 2. Initialize Workspace

Initialize granary in the project directory:

```bash
granary init
```

This creates a `.granary/` directory with the SQLite database.

## 3. Verify Setup

Check that granary is working:

```bash
granary doctor
```

## Done

Granary is now ready. The user can:

- Create projects with `granary projects create "Project Name" --description "..."`
- Create tasks with `granary project <id> tasks create "Task title" --description "..."`
- Start sessions with `granary session start "session-name"`