BlueprintsCLI

A command-line tool for storing and finding code snippets using semantic search

terminal

$ blueprintsCLI submit ./snippet.js --lang=javascript
Analyzing code snippet...
Generated metadata:
Name: "React useState Hook Example"
Description: "Demonstrates basic usage of React's useState hook for state management"
Categories: ["react", "hooks", "state-management"]
Snippet stored successfully with ID: 5f8d3a7b

Core Features

Submit Code

Store code snippets with automatically generated metadata including name, description, and categories.

Semantic Search

Find snippets using natural language queries that understand the meaning behind your code.

Organized Listings

Browse all your stored snippets with their metadata in a structured, easily navigable format.

Visual Workflow

Input Code

$ blueprintsCLI submit ./auth-middleware.js

Submit your code snippet or file through the command line interface.

Process Metadata

Generating metadata...
Name: "JWT Authentication Middleware"
Description: "Express middleware for JWT authentication"
Tags: ["nodejs", "authentication", "express"]

The tool analyzes your code and generates descriptive metadata automatically.

Search & Retrieve

$ blueprintsCLI search "how to verify JWT token"
Found 3 matching blueprints:
1. JWT Authentication Middleware (nodejs)
2. JWT Verification Utility (javascript)

Find your code later using natural language queries that understand the context.

Powered By

PostgreSQL

With pgvector extension for efficient similarity search

Google Embeddings

text-embedding-004 model for semantic understanding

OpenAI/Gemini

For metadata generation and AI-powered features

CLI First

Designed for developer workflows with minimal friction

Command Reference

Submit a Snippet

$ blueprintsCLI submit [file_path]
Options:
--lang, -l: Specify language
--name, -n: Custom name
--desc, -d: Custom description

Submit a code file or snippet to be stored with automatically generated metadata.

Search Snippets

$ blueprintsCLI search "query"
Options:
--limit, -l: Result limit
--lang, -l: Filter by language

Find code snippets using natural language queries that understand the context of your code.

List Snippets

$ blueprintsCLI list
Options:
--limit, -l: Result limit
--offset, -o: Pagination offset

View all stored snippets with their metadata in a structured format.

View Snippet

$ blueprintsCLI view [id]
Options:
--raw: Output raw code
--meta: Only metadata

Display the full details of a specific snippet including code and metadata.

Get Started with BlueprintsCLI

Installation

# Using npm
npm install -g blueprints-cli
# Or with yarn
yarn global add blueprints-cli

Configuration

# Set up your API keys
export BLUEPRINTS_OPENAI_KEY=your_key_here
export BLUEPRINTS_GEMINI_KEY=your_key_here
export DATABASE_URL=postgres://user:pass@host:port/db

First Command

# Submit your first snippet
blueprintsCLI submit ./example.js

View Full Documentation