What is LogicStamp?
LogicStamp Context is an open-source CLI that generates AI-ready context bundles from your React/TypeScript codebase. No setup, no configuration—just install and run.
The Problem LogicStamp Solves
Today, working with AI on a real project usually means copying full source files, README snippets, and screenshots into a chat window. That approach:
Wastes Tokens
Boilerplate, imports, and low-signal code instead of contracts that actually matter
No Global View
AI can't see component relationships, dependency graphs, or file structure
Stale Documentation
Documentation drifts away from your real code over time
Not Automatable
Impossible to automate in CI/CD - can't diff manual chat pastes
💡 Solution: LogicStamp replaces this manual process with a repeatable CLI that scans your codebase and emits folder-organized context files (context.json per folder plus a context_main.json index) describing the structure and contracts of your system in a way that LLMs can consume directly.
Core Idea: The Architectural Blueprint
Think of LogicStamp as an architectural blueprint generator for your codebase. Instead of giving an AI every brick and nail (every line of source), you hand it a compact blueprint that shows:
Component Inventory
Which components, modules, and files exist
Dependency Graph
How they import and depend on one another
Public Contracts
Props, function signatures, types, and interfaces
Key Behaviors
Where important logic lives without full implementations
✨ Result: This blueprint is optimized for AI: high-signal, low-noise, easy to stream into a chat, an agent, or a RAG pipeline.
What LogicStamp Context Provides
The LogicStamp Context CLI is a lightweight, zero-config tool that provides:
Context Generation
Scan React/TypeScript codebase and emit folder-organized context files with component contracts, logic signatures, and dependency graphs
Token Optimization
Built-in token cost analysis for GPT-4o-mini and Claude. Save up to ~65% tokens by including headers and contracts instead of full source
Dependency Graph
Show which components import which others, so AI can reason about data flows and relationships across files
Context Drift Detection
Compare context files to track changes between commits, PRs, or deployments. Detects added, orphaned, and changed folders
Validation
Ensure context files are well-formed and schema-compliant before sharing with teammates or committing to CI
Project Initialization
Set up .gitignore patterns and generate LLM_CONTEXT.md to help AI assistants understand your project structure
Cleanup Utilities
Remove all generated context artifacts when resetting or switching branches. Safe by default with dry-run mode
CLI Commands
All features are exposed through simple CLI commands:
stamp initHow It Fits Into Your Workflow
Install LogicStamp Context
Install globally to use the CLI from anywhere on your system
Generate Context Files
Run the context generator to analyze your codebase and create structured bundles
On first run, you'll be prompted to set up .gitignore and LLM_CONTEXT.md
Share with AI Assistants
Use the generated context files with Claude, ChatGPT, or custom agents instead of pasting full source files
Track Changes (Optional)
OptionalDetect drift across all folders or compare specific files. Perfect for CI workflows
✨ Result: A repeatable, automatable way to give AI an accurate, up-to-date understanding of your codebase that scales with your team.
When LogicStamp is a Great Fit
You regularly ask AI to work on the same codebase (feature work, refactors, debugging)
Your project is large enough that pasting full files hits token or context limits
You want teammates and CI pipelines to share the same view of the system when using AI
You care about reproducibility: you want to know exactly what context the AI saw
What LogicStamp is Not
Not an LLM or chat UI itself; it powers the context you feed into those tools
Not a replacement for good code comments or high-level design docs
Does not auto-fix your code – instead, it makes AI significantly better at reading and modifying your existing codebase
Ready to Get Started?
For complete documentation including all commands, options, troubleshooting guides, and advanced features, check out the comprehensive reference or start with the installation guide.