Lightweight CLI for logging enhancements, bugs, and ideas to structured markdown files with project-aware defaults and tag aggregation.
Perfect for teams that track work in Git repositories, want searchable local markdown documents, or need headless batch capture for CI/CD pipelines.
npm install -g meatycaptureOr with pnpm:
pnpm install -g meatycaptureVerify the installation:
meatycapture --version
meatycapture --helpNeed a different installation method? MeatyCapture also supports Homebrew, standalone binaries, and building from source. See the complete installation guide for all options and platform-specific instructions.
Initialize configuration and create your first project:
# Set up default configuration
meatycapture config init
# Create a new project
meatycapture project add --interactive
# Create a request log document
meatycapture log create --interactive| Command | Purpose |
|---|---|
meatycapture log create |
Create a new request log document |
meatycapture log append |
Add items to an existing document |
meatycapture log view |
View a request log document |
meatycapture log search |
Search across request logs |
meatycapture project add |
Register a new project |
meatycapture config set |
Configure API mode or storage |
Local Mode (Default)
Stores documents in ~/.meatycapture/. No server required. Perfect for local development and Git-based workflows.
API Mode Connect to a MeatyCapture server for centralized storage:
meatycapture config set api_url https://meatycapture.example.comMeatyCapture generates structured markdown files with frontmatter:
---
type: request-log
doc_id: REQ-20250121-meatycapture
item_count: 2
tags: [ux, api]
---
### REQ-20250121-meatycapture-01 - Feature title
**Type:** enhancement | **Priority:** medium | **Status:** triage
**Tags:** ux
- Description and details...Documents are fully searchable and play nicely with Git-based workflows.
- Full CLI Documentation - Complete command reference and examples
- Configuration Guide - Environment variables and settings
- Usage Examples - Real-world usage patterns
- Node.js 18.0.0 or higher
- pnpm 8.0.0 or higher (if building from source)
MeatyCapture is built with TypeScript and includes both a CLI and optional React-based UI.
For development setup and full architecture information, see the repository.
See the LICENSE file in the repository.