Welcome to the Focus.sh documentation. This AI-powered CLI task manager helps you stay productive with natural language task management and beautiful terminal interfaces.
- Installation - Get Focus.sh running on your system
- Configuration - Set up AI providers and preferences
- Commands - Complete command reference
- Themes - Visual customization options
- Troubleshooting - Common issues and solutions
- FAQ - Frequently asked questions
- Contributing - How to contribute to Focus.sh
- Architecture - System design and components
- API Reference - Internal APIs and interfaces
- Testing - Test suite and guidelines
- Development Setup - Local development environment
- Changelog - Version history and changes
- Roadmap - Future development plans
- Security - Security policy and reporting
- License - MIT License details
- Historical development plans and status reports
- Technical analysis documents
- Implementation notes and research
- Install dependencies: Go 1.21+ and Ollama
- Pull AI model:
ollama pull qwen2.5:1.5b - Run Focus.sh:
go run cmd/focus/main.go unified
Focus.sh uses AI for natural language task processing:
- Model:
qwen2.5:1.5b(recommended) - Privacy: All processing happens locally
- Setup:
ollama pull qwen2.5:1.5b
- Usage: When local AI is unavailable
- Models: Various models available
- Setup: Requires API key
See Configuration Guide for detailed setup.
- Natural Language Tasks: Add tasks with plain English
- AI-Powered Insights: Smart categorization and prioritization
- Beautiful Terminal UI: Synthwave themes and modern design
- Calendar Integration: Task scheduling and calendar views
- Cross-Platform: Windows, macOS, and Linux support
- Interactive Dashboards: Multiple TUI interfaces
- Local First: Data stored locally with optional cloud features
- 🐛 Report Issues: GitHub Issues
- 💬 Community: GitHub Discussions
- 🔒 Security: See Security Policy
- 📖 Documentation: Browse the sections above
Last updated: 2024-01-XX