{"id":35771463,"url":"https://github.com/sirecodes/hackathon-todo-app","last_synced_at":"2026-01-07T04:19:04.537Z","repository":{"id":331009620,"uuid":"1124826098","full_name":"sirecodes/Hackathon-Todo-App","owner":"sirecodes","description":"Phase I: Todo In-Memory Python Console App","archived":false,"fork":false,"pushed_at":"2025-12-29T18:10:17.000Z","size":114,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-01T23:34:26.625Z","etag":null,"topics":["claude-code","gemini-api","python3","uv"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sirecodes.png","metadata":{"files":{"readme":"README.md","changelog":"history/prompts/001-cli-todo-app/001-generate-task-breakdown-for-todo-app.tasks.prompt.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-12-29T17:21:07.000Z","updated_at":"2025-12-29T18:11:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sirecodes/Hackathon-Todo-App","commit_stats":null,"previous_names":["sirecodes/hackathon-todo-app"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sirecodes/Hackathon-Todo-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirecodes%2FHackathon-Todo-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirecodes%2FHackathon-Todo-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirecodes%2FHackathon-Todo-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirecodes%2FHackathon-Todo-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sirecodes","download_url":"https://codeload.github.com/sirecodes/Hackathon-Todo-App/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirecodes%2FHackathon-Todo-App/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28232395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-07T02:00:05.975Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["claude-code","gemini-api","python3","uv"],"created_at":"2026-01-07T04:19:02.386Z","updated_at":"2026-01-07T04:19:04.531Z","avatar_url":"https://github.com/sirecodes.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Todo App - CLI Task Manager\n\nA lightweight, in-memory command-line todo application built with Python 3.13+. Manage your tasks efficiently with a beautiful, color-coded terminal interface.\n\n## Features\n\n- ✅ Add, view, update, and delete todos\n- ✅ Mark todos as complete\n- ✅ Tab autocomplete for commands\n- ✅ Color-coded output with ASCII art\n- ✅ Zero external dependencies\n- ✅ Fast and responsive CLI\n\n## Requirements\n\n- Python 3.13 or higher\n- No external dependencies required\n\n## Installation\n\n### Option 1: Using UV (Recommended)\n\n[UV](https://github.com/astral-sh/uv) is a fast Python package installer and resolver.\n\n1. **Install UV** (if not already installed):\n   ```bash\n   curl -LsSf https://astral.sh/uv/install.sh | sh\n   ```\n\n2. **Clone the repository**:\n   ```bash\n   git clone \u003cyour-repo-url\u003e\n   cd Hackathon-Todo-App\n   ```\n\n3. **Run with UV**:\n   ```bash\n   uv run src/app.py\n   ```\n\nUV will automatically handle Python version compatibility and run the application.\n\n### Option 2: Standard Python\n\n1. **Clone the repository**:\n   ```bash\n   git clone \u003cyour-repo-url\u003e\n   cd Hackathon-Todo-App\n   ```\n\n2. **Verify Python version**:\n   ```bash\n   python --version  # Should be 3.13+\n   ```\n\n3. **Run the application**:\n   ```bash\n   python src/app.py\n   ```\n\n## Usage\n\n### Commands\n\nOnce the application is running, use these commands:\n\n| Command    | Description                    |\n|------------|--------------------------------|\n| `add`      | Add a new todo                 |\n| `view`     | View all todos                 |\n| `update`   | Update an existing todo        |\n| `delete`   | Delete a todo                  |\n| `complete` | Mark a todo as complete        |\n| `help`     | Show the command menu          |\n| `exit`     | Exit the application           |\n\n**Tip**: Use TAB to autocomplete commands!\n\n### Example Workflow\n\n```bash\n# Start the app\npython src/app.py\n\n# Add a todo\nCommand: add\nEnter todo description: Buy groceries\n\n# View all todos\nCommand: view\n\n# Mark as complete\nCommand: complete\nEnter todo ID to mark complete: 1\n\n# Exit\nCommand: exit\n```\n\n## Project Structure\n\n```\nHackathon-Todo-App/\n├── src/\n│   ├── app.py           # Main CLI interface\n│   └── todo_manager.py  # Todo data management\n├── specs/               # Feature specifications\n├── .specify/            # Development templates\n└── README.md\n```\n\n## Technical Details\n\n- **Storage**: In-memory (data is lost when app closes)\n- **ID System**: Auto-incrementing integers\n- **Status Types**: `pending` | `complete`\n- **Python Version**: 3.13+\n- **Dependencies**: None (uses only standard library)\n\n## Development\n\nThis project follows Spec-Driven Development (SDD) principles. See the `specs/` directory for detailed specifications, plans, and task breakdowns.\n\n### Documentation\n\n- **Specification**: `specs/001-cli-todo-app/spec.md`\n- **Implementation Plan**: `specs/001-cli-todo-app/plan.md`\n- **Task Breakdown**: `specs/001-cli-todo-app/tasks.md`\n- **Implementation Report**: `specs/001-cli-todo-app/implement.md`\n\n## Limitations\n\n- No data persistence (Phase I by design)\n- Single-user only\n- Terminal-based interface only\n- Tab autocomplete may not work on all Windows terminals\n\n## Future Enhancements (Phase II)\n\n- File-based or database persistence\n- Categories and tags\n- Due dates and priorities\n- Search and filter functionality\n- Export to CSV/JSON\n\n## License\n\n[Your License Here]\n\n## Contributing\n\nContributions are welcome! Please follow the Spec-Driven Development workflow outlined in `.specify/`.\n\n---\n\n**Version**: Phase I (In-Memory)  \n**Status**: Production Ready  \n**Last Updated**: 2025-12-29\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirecodes%2Fhackathon-todo-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsirecodes%2Fhackathon-todo-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirecodes%2Fhackathon-todo-app/lists"}