{"id":31639970,"url":"https://github.com/mgldvd/task-gui","last_synced_at":"2025-10-07T02:08:44.899Z","repository":{"id":317264851,"uuid":"1066034873","full_name":"Mgldvd/task-gui","owner":"Mgldvd","description":"Task Runner GUI (taskg) is a minimal terminal UI wrapper around the excellent Task project: https://taskfile.dev/ ","archived":false,"fork":false,"pushed_at":"2025-09-29T22:22:21.000Z","size":2324,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-29T22:26:09.421Z","etag":null,"topics":["cli","go","taskfile","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Mgldvd.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-09-28T23:11:05.000Z","updated_at":"2025-09-29T22:22:24.000Z","dependencies_parsed_at":"2025-09-29T22:26:11.687Z","dependency_job_id":"43fb921b-9ec7-4253-a81e-ddd61983ab96","html_url":"https://github.com/Mgldvd/task-gui","commit_stats":null,"previous_names":["mgldvd/task-gui"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Mgldvd/task-gui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgldvd%2Ftask-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgldvd%2Ftask-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgldvd%2Ftask-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgldvd%2Ftask-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mgldvd","download_url":"https://codeload.github.com/Mgldvd/task-gui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mgldvd%2Ftask-gui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278708004,"owners_count":26031932,"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":"2025-10-07T02:00:06.786Z","response_time":59,"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":["cli","go","taskfile","tui"],"created_at":"2025-10-07T02:08:19.622Z","updated_at":"2025-10-07T02:08:44.889Z","avatar_url":"https://github.com/Mgldvd.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"img/logo.png\" alt=\"Task Runner TUI\" width=\"240\" /\u003e\n\n# Task Runner TUI (taskg)\n\n_Terminal task explorer with vibes._\n\n\u003c/div\u003e\n\n\u003e ⚠️ **Not affiliated with the Task project**\n\u003e\n\u003e This repository is an independent wrapper UI for the Task project (https://taskfile.dev/).\n\u003e It is not affiliated with, endorsed by, or maintained by the original Task project maintainers.\n\n\nTask Runner TUI (taskg) is a minimal **terminal UI** wrapper around the excellent **Task** project: https://taskfile.dev/\nIt discovers tasks (including those from includes/extends), lets you filter instantly, and then runs the selected task after the UI exits. Zero streaming pane, zero fluff.\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"img/app.png\" alt=\"Gogh\" width=\"100%\" style=\"max-width: 100%;\"\u003e\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"img/VibeCodeLogo.png\" alt=\"VibeCodingLogo\" width=\"300\" /\u003e\n\n**A Vibe Coding Project**\n\n\u003c/div\u003e\n\n\u003e ⚠️ **Notice**\n\u003e This is a **Vibe Coding** side project. Regular issue triage is not guaranteed. **Please open Issues only when accompanied by a Pull Request** (bug fix or improvement). I’m still learning and playing with GO; PR‑first keeps the project moving. All constructive contributions are welcome.\n\n\n## Quick Features\n* Auto Taskfile discovery (walks up directories)\n* Tabs: prefix before first `-` → grouped tab; no dash → Main\n* Instant incremental search (just type or press `/`)\n* Clean two-line header + tab bar + scrollable task list\n* Keyboard first; optional mouse\n* Dark / light themes (`--theme=dark|light`)\n\n## Requirements\nYou must have the [Task CLI](https://taskfile.dev/installation/) installed and available on your `PATH` (the binary is usually named `task`).\nIf `task` is missing, the UI can launch but will not discover tasks.\n\n## Quick Start\nEnsure `task` works first:\n```bash\ntask --version\n```\n\n```bash\nmake build   # or: go build ./cmd/taskg\n./taskg      # run inside any repo with a Taskfile\n```\n\nOptional:\n```bash\n./taskg --theme=light\n./taskg --no-mouse\n./taskg --project ../other/repo\n```\n\nInstalling via installer script\n-------------------------------\n\nAn installer script is included to clone, build and install `taskg` to `/usr/local/bin`.\n\nFrom a system with Git and Go installed you can run:\n\n```bash\n# run installer with defaults (uses this repo)\nbash install.sh\n\n# or pipe from remote (replace URL with canonical host if published):\ncurl -sL https://raw.githubusercontent.com/Mgldvd/task-gui/master/install.sh | bash\n```\n\nYou can also specify a different repo or branch:\n\n```bash\n./install.sh https://github.com/\u003cowner\u003e/\u003crepo\u003e.git main\n```\n\nAfter install, run:\n\n```bash\ntaskg --help\n```\n\n\n## Key Shortcuts\n| Key | Action |\n|-----|--------|\n| ↑ / k | Up |\n| ↓ / j | Down |\n| PgUp / PgDn | Fast scroll |\n| Home / End | Jump list edges |\n| ← / → / Tab / Shift+Tab | Switch tabs |\n| / | Search mode |\n| Esc | Clear / exit search |\n| Enter | Run selected task \u0026 quit |\n| q / Ctrl+C | Quit |\n\n## Task Grouping\n`db-migrate` and `db-seed` → tab `db`.  `build` (no dash) → `Main` tab.\n\n## Contributing\nPR‑first workflow:\n1. Fork \u0026 branch (e.g. `feat/x`, `fix/y`).\n2. Keep patches focused \u0026 small.\n3. Run basic checks: `task fmt`, `task lint`, `task test` (or equivalents).\n4. Open PR with a short rationale.\n\nGood first ideas: additional themes, better status messages, lightweight tests for parsing, optional fuzzy search, CI config.\n\n## Acknowledgements\nBuilt on top of the amazing [Task](https://taskfile.dev/) and the Bubble Tea / Lip Gloss ecosystem.\n\n## License\nMIT. Not affiliated with the Task project; this is an independent wrapper UI.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgldvd%2Ftask-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgldvd%2Ftask-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgldvd%2Ftask-gui/lists"}