{"id":35131198,"url":"https://github.com/razbuild/raztodo","last_synced_at":"2026-01-13T22:52:57.210Z","repository":{"id":326287875,"uuid":"1102964440","full_name":"razbuild/raztodo","owner":"razbuild","description":"A fast, minimal dependency command-line todo/task manager backed by SQLite","archived":false,"fork":false,"pushed_at":"2025-12-27T22:41:31.000Z","size":333,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-13T22:52:47.396Z","etag":null,"topics":["commandline","cross-platform","developer-tools","lightweight","minimal","pythoncli","sqlite","task","terminal","todo-cli","todos"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/razbuild.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-24T09:05:47.000Z","updated_at":"2025-12-27T22:41:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/razbuild/raztodo","commit_stats":null,"previous_names":["razbuild/raztodo"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/razbuild/raztodo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razbuild%2Fraztodo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razbuild%2Fraztodo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razbuild%2Fraztodo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razbuild%2Fraztodo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/razbuild","download_url":"https://codeload.github.com/razbuild/raztodo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razbuild%2Fraztodo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28405133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["commandline","cross-platform","developer-tools","lightweight","minimal","pythoncli","sqlite","task","terminal","todo-cli","todos"],"created_at":"2025-12-28T05:14:33.580Z","updated_at":"2026-01-13T22:52:57.205Z","avatar_url":"https://github.com/razbuild.png","language":"Python","readme":"![Logo](https://raw.githubusercontent.com/razbuild/raztodo/master/assets/logo.png)\r\n\r\n![GitHub License](https://img.shields.io/github/license/razbuild/raztodo?logoColor=ffffff\u0026logoSize=auto\u0026label=License\u0026labelColor=1b1b1b\u0026color=ab0000\u0026cacheSeconds=3600)\r\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/razbuild/raztodo/ci.yml?branch=master\u0026event=push\u0026logo=githubactions\u0026logoColor=ffffff\u0026logoSize=auto\u0026label=Build\u0026labelColor=1b1b1b\u0026color=ab0000\u0026cacheSeconds=3600)\r\n![Codecov](https://img.shields.io/codecov/c/github/razbuild/raztodo?logo=codecov\u0026logoColor=ffffff\u0026logoSize=auto\u0026label=Coverage\u0026labelColor=1b1b1b\u0026color=ba0000\u0026cacheSeconds=3600)\r\n![PyPI - Version](https://img.shields.io/pypi/v/raztodo?pypiBaseUrl=https%3A%2F%2Fpypi.org\u0026logo=pypi\u0026logoColor=ffffff\u0026logoSize=auto\u0026label=PyPi\u0026labelColor=1b1b1b\u0026color=ba0000\u0026cacheSeconds=3600)\r\n![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Frazbuild%2Fraztodo%2Fmain%2Fpyproject.toml\u0026logo=python\u0026logoColor=ffffff\u0026logoSize=auto\u0026label=Python\u0026labelColor=1b1b1b\u0026color=ab0000\u0026cacheSeconds=3600)\r\n\r\n---\r\n\r\n## About\r\n\r\nRazTodo is a lightweight, cross-platform CLI task manager powered by SQLite, offering fast, privacy-first todo management with minimal external dependencies.\r\n\r\n| Preview |\r\n|:-------:|\r\n| ![Preview](https://raw.githubusercontent.com/razbuild/raztodo/master/assets/preview.gif) |\r\n\r\n---\r\n\r\n## Why RazTodo?\r\n\r\n**Lightweight \u0026 Fast** — Minimal dependencies, SQLite-powered, optimized for speed  \r\n**Privacy-First** — Your data stays local, no cloud services, no tracking  \r\n**Developer-Friendly** — Clean Architecture, well-tested, type-safe, modern Python  \r\n**Simple \u0026 Powerful** — Intuitive CLI, works out of the box, rich features  \r\n**Cross-Platform** — Works seamlessly on Linux, macOS, and Windows  \r\n\r\nPerfect for developers, power users, and anyone who wants a fast, reliable, local-first task manager.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\n# Recommended: Install via pipx (isolated environment)\r\npipx install raztodo\r\n\r\n# Alternative: Install via pip\r\npip install raztodo\r\n```\r\n\r\n\u003e 📖 For more installation options (virtual environments, from source), see the [Installation Guide](https://github.com/razbuild/raztodo/blob/master/docs/INSTALLATION.md)\r\n\r\n### Basic Usage\r\n\r\n```bash\r\n# Create a task with priority and due date\r\nrt add \"Buy groceries\" --priority H --due 2024-12-31\r\n\r\n# List all tasks\r\nrt list\r\n\r\n# Mark task as done\r\nrt done 1\r\n\r\n# Search for tasks\r\nrt search \"groceries\"\r\n\r\n# Update a task\r\nrt update 1 --title \"Buy groceries and milk\"\r\n\r\n# Delete a task\r\nrt remove 1\r\n```\r\n\r\n\u003e 📖 For complete command reference, see the [Usage Guide](https://github.com/razbuild/raztodo/blob/master/docs/USAGE.md)\r\n\r\n---\r\n\r\n## Features\r\n\r\n- ✅ **Task Management** — Create, update, delete, and organize tasks\r\n- 🏷️ **Tags \u0026 Projects** — Organize tasks with tags and project names\r\n- 🔍 **Full-Text Search** — Search across all task fields\r\n- 📅 **Due Dates \u0026 Priority** — Set deadlines and priority levels (L/M/H)\r\n- 💾 **Import/Export** — Backup and restore tasks via JSON\r\n- 🎨 **Colored Output** — Beautiful ANSI colors and icons\r\n- 🗄️ **SQLite Storage** — No external services required\r\n- 🚀 **Cross-Platform** — Works on Linux, macOS, and Windows\r\n- ⚡ **Fast Performance** — Lazy loading and optimized architecture\r\n- 🏗️ **Clean Architecture** — Maintainable and testable codebase\r\n\r\n---\r\n\r\n## Commands\r\n\r\n| Command | Description | Example |\r\n|---------|-------------|---------|\r\n| `add` | Create a new task | `rt add \"Task title\" --priority H` |\r\n| `list` | List tasks with filters | `rt list --pending --priority H` |\r\n| `update` | Update a task | `rt update 1 --title \"New title\"` |\r\n| `done` | Mark task as done/undone | `rt done 1` |\r\n| `remove` | Delete a task | `rt remove 1` |\r\n| `search` | Search tasks | `rt search \"keyword\"` |\r\n| `export` | Export to JSON | `rt export backup.json` |\r\n| `import` | Import from JSON | `rt import backup.json` |\r\n| `migrate` | Run database migration | `rt migrate` |\r\n| `clear` | Delete all tasks | `rt clear --confirm` |\r\n\r\n```bash\r\n# Get help for any command\r\nrt --help\r\nrt add --help\r\n```\r\n\r\n\u003e 📖 See the [Usage Guide](https://github.com/razbuild/raztodo/blob/master/docs/USAGE.md) for detailed command documentation\r\n\r\n---\r\n\r\n## Configuration\r\n\r\nRazTodo can be configured using environment variables:\r\n\r\n| Variable | Description | Default |\r\n|----------|-------------|---------|\r\n| `RAZTODO_DB` | Database filename or path | `tasks.db` |\r\n| `LOG_LEVEL` | Logging level | `ERROR` |\r\n\r\n**Example:**\r\n\r\n```bash\r\n# Use a custom database location\r\nexport RAZTODO_DB=\"/path/to/custom.db\"\r\n\r\n# Enable debug logging\r\nexport LOG_LEVEL=\"DEBUG\"\r\n```\r\n\r\n\u003e 📖 For detailed configuration options, see the [Configuration Guide](https://github.com/razbuild/raztodo/blob/master/docs/CONFIGURATION.md)\r\n\r\n---\r\n\r\n## Documentation\r\n\r\nComplete documentation is available in the `docs/` directory:\r\n\r\n- 📦 **[Installation Guide](https://github.com/razbuild/raztodo/blob/master/docs/INSTALLATION.md)** — Install via pip, pipx, or from source\r\n- 📖 **[Usage Guide](https://github.com/razbuild/raztodo/blob/master/docs/USAGE.md)** — Complete command reference with examples\r\n- ⚙️ **[Configuration Guide](https://github.com/razbuild/raztodo/blob/master/docs/CONFIGURATION.md)** — Environment variables and options\r\n- 🏗️ **[Architecture](https://github.com/razbuild/raztodo/blob/master/docs/ARCHITECTURE.md)** — Project structure and design patterns\r\n- 🧪 **[Testing](https://github.com/razbuild/raztodo/blob/master/docs/TESTING.md)** — Running tests and development setup\r\n- 📝 **[Changelog](https://github.com/razbuild/raztodo/blob/master/CHANGELOG.md)** — Release notes and version history\r\n\r\n---\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Here's how you can help:\r\n\r\n1. **Fork the repository**\r\n2. **Create a feature branch**: `git checkout -b feature/your-feature-name`\r\n3. **Make your changes** and ensure quality:\r\n   ```bash\r\n   # Run tests\r\n   pytest\r\n   \r\n   # Check code quality\r\n   ruff check src/ tests/\r\n   black --check src/ tests/\r\n   mypy src/\r\n   ```\r\n4. **Submit a pull request**\r\n\r\nFor detailed guidelines, see the [Contributing Guide](https://github.com/razbuild/raztodo/blob/master/CONTRIBUTING.md).\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT License\r\n\r\n---\r\n\r\n## Support\r\n\r\n- 🐛 **Found a bug?** [Open an issue](https://github.com/razbuild/raztodo/issues)\r\n- 💡 **Have a suggestion?** [Open an issue](https://github.com/razbuild/raztodo/issues)\r\n- 📧 **Questions?** Check the [Documentation](https://github.com/razbuild/raztodo/blob/master/docs/)\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frazbuild%2Fraztodo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frazbuild%2Fraztodo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frazbuild%2Fraztodo/lists"}