SuperSmall Documentation

Welcome to the official documentation for SuperSmall - a high-performance code analysis tool that optimizes context for Claude and Anthropic APIs.

Overview

SuperSmall is a powerful CLI toolset designed to intelligently analyze and index source code repositories, creating optimized context packages that reduce API token usage while maintaining high response quality. It integrates seamlessly with Claude Code and Kandi CLI to provide enhanced context-aware capabilities.

Key Features

- 🚀 High-Performance Indexing: Analyze repositories with code repositories efficiently - 🎯 Smart Context Optimization: Reduce API token usage through intelligent context selection - 🔌 Native Integration: Built-in support for Claude Code and Kandi CLI workflows - 📊 Multi-Language Support: Works with Swift, TypeScript, JavaScript, Python, Go, Rust, and more - 💾 Efficient Storage: Export and import indexes for CI/CD integration - 🔄 Incremental Updates: Keep your index current with minimal overhead

Quick Start

Install SuperSmall
git clone [repository-url].git
cd supersmall-cli-osx-alpha
swift build -c release
sudo cp .build/release/supersmall /usr/local/bin/


Initialize your repository
cd /path/to/your/project
supersmall init


Query for optimized context
supersmall query "How does the authentication system work?"



Documentation Structure


[Getting Started](getting-started/installation.md)
- [Installation Guide](getting-started/installation.md)
- [Quick Start Tutorial](getting-started/quickstart.md)
- [Basic Concepts](getting-started/concepts.md)


[Command Reference](commands/overview.md)
- [Complete Command List](commands/overview.md)
- [Core Commands](commands/core.md)
- [Integration Commands](commands/integration.md)
- [Data Management](commands/data.md)


[Integration Guides](integration/overview.md)
- [Claude Code Integration](integration/claude-code.md)
- [Kandi CLI Integration](integration/kandi-cli.md)
- [CI/CD Workflows](integration/cicd.md)


[Advanced Topics](advanced/overview.md)
- [Optimization Strategies](advanced/optimization.md)
- [Performance Tuning](advanced/performance.md)
- [Custom Workflows](advanced/workflows.md)
- [Troubleshooting](advanced/troubleshooting.md)


Use Cases


For Individual Developers
- Quickly understand large codebases
- Generate optimized prompts for AI assistance
- Reduce API costs while maintaining quality


For Teams
- Share repository knowledge through exported indexes
- Standardize AI-assisted development workflows
- Integrate with CI/CD pipelines


For Open Source Projects
- Help contributors understand project structure
- Generate context-aware documentation
- Provide better AI assistance for issue resolution


System Requirements


- Operating System: macOS 10.15 or later
- Swift: 5.10 or later
- Xcode Command Line Tools: Required for building from source
- Memory: 1GB minimum, 4GB recommended for large repositories
- Storage: 100MB for application, varies for indexes


Getting Help


- GitHub Issues: Report bugs or request features
- Discord Community: Join the community
- Email Support: [contact-info]


License


SuperSmall is released under the MIT License. See LICENSE for details.