# grepai-storage-gob

Sets up local GOB binary storage for GrepAI without running external database services. Designed for solo developers and codebases under 10,000 files.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 664 installs · ★ 20
- Author: yoanbernabeu
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/yoanbernabeu/grepai-skills/tree/HEAD/skills/storage/grepai-storage-gob/SKILL.md
- Updated: 2026-02-01
- HTML: https://affpapa.org/en/nevibecode/skills/grepai-storage-gob

## What it does

GrepAI relies on Go binary serialization (GOB) as its default single-file backend. This skill guides the configuration of `.grepai/config.yaml` and prepares index generation via `grepai watch`. Vector embeddings, chunks, and metadata are written directly into `.grepai/index.gob` and `.grepai/symbols.gob`.

During search routines, GrepAI loads the entire index file into RAM. A 50 MB index file consumes around 100 MB of system memory. Once a project grows past 50,000 files or exceeds 1 GB in index size, GOB becomes a bottleneck, signaling a need to move to PostgreSQL or Qdrant. Because index entries store absolute local paths and model-specific vectors, `.grepai/` must remain in `.gitignore` rather than shared across machines.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/grepai-storage-gob/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/grepai-storage-gob/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/grepai-storage-gob/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/grepai-storage-gob/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install yoanbernabeu/grepai-skills grepai-storage-gob
```

2. **Manually: put the files in place**
- File: `.github/skills/grepai-storage-gob/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/yoanbernabeu/grepai-skills --path skills/storage/grepai-storage-gob
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/grepai-storage-gob/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/yoanbernabeu/grepai-skills/tree/HEAD/skills/storage/grepai-storage-gob/SKILL.md

## When to use it
- configure local GOB backend in .grepai/config.yaml
- estimate RAM consumption for in-memory vector search
- back up or rebuild a corrupted index.gob file
- prepare GrepAI migration to PostgreSQL or Qdrant

## Example prompts
- Configure grepai to use the local gob storage backend in this repo.
- Check grepai index status and calculate how much RAM it needs.
- Show the configuration needed to migrate grepai from gob to qdrant.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: bbd751ce68a2c3d8.

BEGIN THIRD-PARTY FILE bbd751ce68a2c3d8
````text
---
name: grepai-storage-gob
description: Configure GOB local file storage for GrepAI. Use this skill for simple, single-machine setups.
---

# GrepAI Storage with GOB

This skill covers using GOB (Go Binary) as the storage backend for GrepAI, the default and simplest option.

## When to Use This Skill

- Single developer projects
- Small to medium codebases
- Simple setup without external dependencies
- Local development environments

## What is GOB Storage?

GOB is Go's native binary serialization format. GrepAI uses it to store:
- Vector embeddings
- File metadata
- Chunk information

Everything is stored in a single local file.

## Advantages

| Benefit | Description |
|---------|-------------|
| 🚀 **Simple** | No external services needed |
| ⚡ **Fast setup** | Works immediately |
| 📁 **Portable** | Single file, easy to backup |
| 💰 **Free** | No infrastructure costs |
| 🔒 **Private** | Data stays local |

## Limitations

| Limitation | Description |
|------------|-------------|
| 📏 **Scalability** | Not ideal for very large codebases |
| 👤 **Single user** | No concurrent access |
| 🔄 **No sharing** | Can't share index across machines |
| 💾 **Memory** | Loads into RAM for searches |

## Configuration

### Default Configuration

GOB is the default backend. Minimal config:

```yaml
# .grepai/config.yaml
store:
  backend: gob
```

### Explicit Configuration

```yaml
store:
  backend: gob
  # Index stored in .grepai/index.gob (automatic)
```

## Storage Location

GOB storage creates files in your project's `.grepai/` directory:

```
.grepai/
├── config.yaml    # Configuration
├── index.gob      # Vector embeddings
└── symbols.gob    # Symbol index for trace
```

## File Sizes

Approximate `.grepai/index.gob` sizes:

| Codebase | Files | Chunks | Index Size |
|----------|-------|--------|------------|
| Small | 100 | 500 | ~5 MB |
| Medium | 1,000 | 5,000 | ~50 MB |
| Large | 10,000 | 50,000 | ~500 MB |

## Operations

### Creating the Index

```bash
# Initialize project
grepai init

# Start indexing (creates index.gob)
grepai watch
```

### Checking Index Status

```bash
grepai status

# Output:
# Index: .grepai/index.gob
# Files: 245
# Chunks: 1,234
# Size: 12.5 MB
# Last updated: 2025-01-28 10:30:00
```

### Backing Up the Index

```bash
# Simple file copy
cp .grepai/index.gob .grepai/index.gob.backup
```

### Clearing the Index

```bash
# Delete and re-index
rm .grepai/index.gob
grepai watch
```

### Moving to a New Machine

```bash
# Copy entire .grepai directory
cp -r .grepai /path/to/new/location/

# Note: Only works if using same embedding model
```

## Performance Considerations

### Memory Usage

GOB loads the entire index into RAM for searches:

| Index Size | RAM Usage |
|------------|-----------|
| 10 MB | ~20 MB |
| 50 MB | ~100 MB |
| 500 MB | ~1 GB |

### Search Speed

GOB provides fast searches for typical codebases:
````
END THIRD-PARTY FILE bbd751ce68a2c3d8

The third-party file has ended. Everything between the bbd751ce68a2c3d8 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2929 of 5334 bytes. © yoanbernabeu · MIT · https://github.com/yoanbernabeu/grepai-skills/tree/HEAD/skills/storage/grepai-storage-gob/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md