Cache — Self-hosted snippets across browser, CLI, and API

Documentation

Install the app, sign in, work from the CLI, and integrate against the API without guessing what is implemented today.

Getting Started

Install Cache and get a local library running

Open section

Introduction

Overview of the self-hosted app and workflow

Quick Start

Create an owner, add a snippet, and search it back

Installation

Clone the repo, configure env vars, and start the app

CLI

Use Cache from a local profile or a remote server

Open section

Overview

CLI modes, profiles, and everyday usage

Commands

Reference for snippet, attachment, auth, and storage commands

Configuration

Where profiles live and how runtime selection works

Authentication

Browser login and token-based remote access

API

HTTP endpoints for snippets, attachments, auth, and storage

Open section

Overview

Auth model and endpoint groups

Authentication

Session cookies, bearer tokens, and CLI browser login helpers

Endpoints

Reference for versioned API routes and health checks

Error Handling

Common response shapes and failure cases

Web App

Public pages, sign-in flow, dashboard, and snippet editing

Open section

Overview

How the web app is split between public and authenticated routes

Dashboard

Browse, search, and open snippets

Snippets

Create, edit, attach files, and delete snippets

Settings

What is configurable today and what still lives in env vars

Features

Core product capabilities and current scope

Open section

Overview

Current capabilities across the browser, CLI, and API

Snippet Management

Create, edit, tag, and delete snippets

Attachments

Adding files to snippets

Find snippets by text and tags