{"id":49917627,"url":"https://github.com/i-schuyler/termux-dashboard","last_synced_at":"2026-05-16T17:45:45.553Z","repository":{"id":350946120,"uuid":"1208306522","full_name":"i-schuyler/termux-dashboard","owner":"i-schuyler","description":"One-tap project entry for Termux and tmux.","archived":false,"fork":false,"pushed_at":"2026-04-12T21:52:05.000Z","size":1942,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T23:26:19.443Z","etag":null,"topics":["android","automation","cli","developer-tools","git","local-first","mobile-development","shell","terminal","termux","tmux","workspace"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/i-schuyler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"i-schuyler","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-04-12T05:07:00.000Z","updated_at":"2026-04-12T21:52:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/i-schuyler/termux-dashboard","commit_stats":null,"previous_names":["i-schuyler/termux-dashboard"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/i-schuyler/termux-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-schuyler%2Ftermux-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-schuyler%2Ftermux-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-schuyler%2Ftermux-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-schuyler%2Ftermux-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i-schuyler","download_url":"https://codeload.github.com/i-schuyler/termux-dashboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-schuyler%2Ftermux-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33112973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"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":["android","automation","cli","developer-tools","git","local-first","mobile-development","shell","terminal","termux","tmux","workspace"],"created_at":"2026-05-16T17:45:44.546Z","updated_at":"2026-05-16T17:45:45.547Z","avatar_url":"https://github.com/i-schuyler.png","language":"Shell","funding_links":["https://github.com/sponsors/i-schuyler"],"categories":[],"sub_categories":[],"readme":"# Termux Dashboard\n\n_One-tap project entry for Termux and tmux._\n\n`termux-dashboard` is a tmux-based mobile developer workspace launcher for Termux.\n\nCore promise: Open the right repo, in the right tmux workspace, with git-aware mobile re-entry in Termux.\n\nStatus: usable alpha. Stable enough for real workflows.\n\n![Termux Dashboard hero screenshot (current project view)](docs/assets/termux-dashboard-hero-current-project.png)\n\n## Why it exists\n\nUsing Termux seriously on Android is powerful, but getting back into the right repo and tmux state is slower and messier than it should be.\n\n`termux-dashboard` gives you a consistent, git-aware, tmux-based project entry flow from a shortcut.\n\n## Who it is for\n\n- Developers who already use Termux seriously.\n- tmux users who want fast mobile re-entry.\n- Firmware, embedded, infra, and shell-heavy engineers.\n- Developers working in short mobile sessions.\n- People who prefer local-first tools and simple shell scripts.\n\n## What it does\n\n- Starts from the `termux-dashboard` shortcut entry point.\n- Creates or reattaches a tmux session with an optional `Aliveness Window` startup (5 windows when enabled, 4 when disabled).\n- Writes aliveness journal entries directly to a configurable note directory.\n- Opens project and script menus with pinned/recent-first selection.\n- Uses git-aware pull gating (prompt only when default branch is behind remote).\n- Keeps repo/runtime behavior source-of-truth in this repository.\n\n`Aliveness Window` is optional and controlled by user-local config.\n\n## Repo scope\n\nThis repository is the source-of-truth for dashboard behavior, tests, and docs.\n\n- Open-source core: local-first shell workflow with clear behavior/docs.\n- Business-compatible posture: paid support/customization can be layered later without changing repo scope.\n- Downstream installer/integration work belongs in `termux-shortcuts`.\n\n## Install status\n\nThis public repo is the source of truth for `termux-dashboard`.\n\nThe widget/integration installer I currently use lives in a private downstream repo for my personal setup, so public installation is manual for now.\n\nFor alpha testing, copy `scripts/termux-dashboard` into your Termux widget shortcuts path and make it executable.\n\nA more public installer path may come later if there is demand.\n\n## Manual install (alpha)\n\nCurrent public installation is manual.\n\nRequirements:\n- Termux\n- tmux\n- Termux:Widget\n\nBasic flow:\n1. Clone this repo into your Termux home directory.\n2. Copy `scripts/termux-dashboard` into your Termux widget shortcuts path.\n3. Make the copied script executable.\n4. Refresh the Termux widget list and launch `termux-dashboard`.\n\nExample commands:\n```sh\ncd ~\ngit clone https://github.com/i-schuyler/termux-dashboard.git\nchmod +x ~/termux-dashboard/scripts/termux-dashboard\nmkdir -p ~/.shortcuts\ncp ~/termux-dashboard/scripts/termux-dashboard ~/.shortcuts/termux-dashboard\nchmod +x ~/.shortcuts/termux-dashboard\n```\n\nA more public installer path may come later if there is demand.\n\n## Repo layout\n\n- `scripts/termux-dashboard` — dashboard launcher and window flows.\n- `tests/lint-shell.sh` — shell syntax + shellcheck lint path.\n- `tests/termux-dashboard-smoke.sh` — tmux behavior smoke tests.\n- `docs/termux-dashboard.md` — dashboard behavior spec.\n- `docs/DECISIONS.md` — dashboard-only architecture/behavior decisions.\n- `docs/INDEX.md` — docs entrypoint for this repo.\n\n## Screenshots and demo\n\n![Termux Dashboard repository landing screenshot](docs/assets/termux-dashboard-repo-landing.png)\n\nDemo clip: [Widget to repo flow (MP4)](docs/assets/termux-dashboard-demo-widget-to-repo.mp4)\n\n## Local testing\n\n```sh\nbash tests/lint-shell.sh\nbash tests/termux-dashboard-smoke.sh\n```\n\n## Downstream integration note\n\n`termux-shortcuts` owns installer/integration concerns. This repo stays focused on `termux-dashboard` runtime behavior and validation.\n\n## Support\n\nIf this is useful and you want to support continued work, GitHub Sponsors helps. I’m also interested in paid setup/customization/support for real workflows.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-schuyler%2Ftermux-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi-schuyler%2Ftermux-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-schuyler%2Ftermux-dashboard/lists"}