KandiForge Glossary
Comprehensive reference for all KandiForge terms, components, and concepts
Categories
KandiForge
The main desktop application ecosystem for AI-assisted software development, available on macOS, Windows, and iOS.
Examples
- KandiForge for macOS
- KandiForge for Windows
- KandiForge iOS Companion
Technical Details
- Native Swift application for macOS and iOS
- C# WPF application for Windows
- Shared API protocols across platforms
- Integrated terminal and project management
Related Terms
KandiKit
The foundational Swift library providing AI services, GitHub integration, and specification management across the Kandi ecosystem.
Examples
- Anthropic API integration
- GitHub OAuth flow
- Conversation management
Technical Details
- Swift Package Manager library
- Observable patterns for UI binding
- Secure credential management
- Cross-platform HTTP client abstraction
Related Terms
Spec
A structured specification document that describes software requirements, implementation details, and acceptance criteria for AI-assisted development.
Examples
- User authentication spec
- API endpoint specification
- UI component requirements
Technical Details
- Markdown-based format
- Template-driven generation
- Version control integration
- AI-parseable structure
Related Terms
Spec Template
Pre-defined specification templates organized by category (Business, Coding, Creative, Documentation) that provide starting points for common development tasks.
Examples
- Login form template
- API design template
- Component architecture template
Technical Details
- Embedded resource system
- Categorized organization
- Customizable placeholders
- Extensible template format
Related Terms
Kandi CLI
Cross-platform command-line interface for executing specs, managing projects, and integrating with CI/CD pipelines.
Examples
- kandi exec-spec "login feature"
- kandi github create-issue
- kandi optimize-context
Technical Details
- Single binary deployment
- Cross-platform Rust implementation
- JSON-based communication protocol
- Process-based tool execution
Related Terms
CLI Library
The foundational library (kandi-cli-library) that provides programmatic access to all Kandi CLI features and tools.
Examples
- Tool execution engine
- Session management
- Logger integration
Technical Details
- Modular tool architecture
- Plugin system for extensibility
- State management and persistence
- Comprehensive logging framework
Related Terms
Tool Executor
The engine responsible for discovering, registering, and executing individual tools within the CLI environment.
Examples
- BashTool execution
- FileOperations tool
- GitHubIntegration tool
Technical Details
- Dynamic tool registration
- Dependency injection pattern
- Error handling and recovery
- Performance monitoring and profiling
Related Terms
AI Assistant
Multi-provider AI integration supporting Anthropic Claude, OpenAI GPT, and xAI Grok for diverse AI assistance throughout the development workflow.
Examples
- Code generation from specs
- Technical documentation creation
- Code review assistance
- Multi-model comparison
Technical Details
- Multi-provider architecture
- Claude 3.5 Sonnet integration
- GPT-4 and GPT-3.5 support
- Grok real-time capabilities
- Provider switching and comparison
Related Terms
OpenAI Integration
OpenAI GPT model integration providing alternative AI assistance with different strengths and capabilities.
Examples
- GPT-4 code generation
- Chat completions
- Function calling
- Code analysis
Technical Details
- OpenAI API v1 integration
- GPT-4 and GPT-3.5-turbo support
- Function calling capabilities
- Chat completions API
- Token usage optimization
Related Terms
Grok Integration
xAI Grok integration providing real-time information access and alternative AI perspectives for development tasks.
Examples
- Real-time web data
- Current technology trends
- Alternative problem approaches
- Fast responses
Technical Details
- xAI API integration
- Real-time web search capabilities
- Up-to-date information access
- Alternative reasoning approaches
- Fast response optimization
Related Terms
AnthropicClient
The HTTP client implementation that handles communication with Anthropic's Claude API, including authentication, streaming, and error handling.
Examples
- Message sending
- Streaming responses
- Token usage tracking
Technical Details
- OAuth 2.0 authentication
- Server-sent events for streaming
- Rate limiting and retry logic
- Comprehensive error handling
Related Terms
Streaming Response
Real-time response delivery from the AI assistant that provides immediate feedback as content is generated, improving user experience.
Examples
- Live code generation
- Real-time typing indicators
- Progressive content loading
Technical Details
- Server-sent events protocol
- Chunk-based content delivery
- UI state synchronization
- Interrupt capability for user control
Related Terms
GitHub Integration
Comprehensive GitHub API integration providing repository management, issue tracking, and automated workflows within the Kandi ecosystem.
Examples
- Repository cloning
- Issue creation from specs
- Pull request automation
Technical Details
- GitHub REST API v4 integration
- OAuth 2.0 Device Flow authentication
- Repository operations and file management
- Webhook integration for real-time updates
Related Terms
OAuth Device Flow
GitHub's device-based authentication mechanism that allows secure login without exposing credentials in desktop and CLI applications.
Examples
- Desktop app GitHub login
- CLI authentication setup
- Token refresh handling
Technical Details
- Device code generation and polling
- Secure token storage in system keychain
- Automatic token refresh mechanism
- Scope-based permission management
Related Terms
Rust Core
The high-performance Rust implementation that powers cross-platform CLI tools, MCP servers, and core library functionality.
Examples
- kandi-rust-cli-exe
- kandi-rust-mcp-server
- kandi-rust-core-lib
Technical Details
- Memory-safe systems programming
- Zero-cost abstractions
- Cross-compilation support
- C-compatible FFI interface
Related Terms
MCP Server
Model Context Protocol server implementation that enables Claude Desktop to discover and execute Kandi tools as native Claude capabilities.
Examples
- Tool discovery for Claude
- Real-time context streaming
- Plugin architecture
Technical Details
- Standard MCP protocol implementation
- JSON-RPC communication
- Tool capability advertisement
- Context-aware tool execution
Related Terms
FFI Bridge
Foreign Function Interface bridge that allows Swift applications to call Rust library functions with type safety and performance.
Examples
- Swift to Rust API calls
- Memory management across languages
- Type conversion
Technical Details
- C-compatible interface layer
- Memory safety across language boundaries
- Async/await pattern preservation
- Error handling translation
Related Terms
SuperSmall
Context optimization tool that reduces token usage by intelligently analyzing and compressing repository content while maintaining relevance.
Examples
- Token reduction for large codebases
- Smart context filtering
- Relevance scoring
Technical Details
- Rust-based context analysis engine
- Machine learning relevance scoring
- Incremental indexing system
- Configurable compression strategies
Related Terms
Context Optimization
The process of reducing and optimizing context sent to AI models to improve response quality while minimizing token costs.
Examples
- Repository indexing
- Relevance filtering
- Smart chunking
Technical Details
- Abstract syntax tree analysis
- Semantic similarity matching
- Progressive context loading
- Cache-based optimization
Related Terms
Cross-Platform
The ability to run the same core functionality across different operating systems (macOS, Windows, Linux) with platform-specific optimizations.
Examples
- Single Rust codebase
- Native UI per platform
- Shared protocols
Technical Details
- Conditional compilation for platform features
- Native system integration per OS
- Shared business logic layer
- Platform-specific UI frameworks
Related Terms
Native Integration
Deep integration with platform-specific features like keychains, file systems, and UI frameworks for optimal user experience.
Examples
- macOS Keychain access
- Windows Credential Manager
- Platform file dialogs
Technical Details
- Platform API abstraction layers
- Native credential storage
- OS-specific file system integration
- Platform UI component usage
Related Terms
Spec Execution
The automated process of taking a specification document and using AI assistance to implement the described functionality.
Examples
- Code generation from spec
- File creation and modification
- Test generation
Technical Details
- Multi-round AI conversation flow
- File operation parsing and execution
- Progress tracking and logging
- Error recovery mechanisms
Related Terms
Session State
Persistent state management that tracks conversation history, project context, and user preferences across application sessions.
Examples
- Conversation history
- Project settings
- User preferences
Technical Details
- SQLite-based local storage
- Encrypted sensitive data storage
- Session migration and backup
- Cross-device synchronization capability