Skip to content

tasctl Reference

djunekz edited this page Apr 10, 2026 · 2 revisions

tasctl Reference

Complete guide to tasctl — the tool for managing Termux App Store itself.


What is tasctl?

tasctl manages Termux App Store as an application — not the packages inside it. Use it to install, update, uninstall, and diagnose TAS.

The distinction:

  • termux-app-store — manages packages in the store
  • tasctl — manages TAS itself

Commands

install

Installs the latest version of Termux App Store.

./tasctl install
# or if tasctl is in PATH:
tasctl install

What it does:

  1. Fetches the latest release from GitHub
  2. Detects CPU architecture automatically
  3. Downloads the correct binary
  4. Copies packages/, tools/, and build-package.sh from the repo
  5. Creates the wrapper symlink at $PREFIX/bin/termux-app-store

update

Updates Termux App Store to the latest version.

tasctl update

uninstall

Removes Termux App Store cleanly.

tasctl uninstall

Removes:

  • $PREFIX/bin/termux-app-store symlink
  • $PREFIX/lib/.tas/ directory

Does not remove:

  • packages/ you created locally
  • Packages already installed via TAS

doctor

Diagnoses the TAS environment and reports any issues.

tasctl doctor

Checks:

  • CPU architecture and binary compatibility
  • Python and pip availability
  • Textual (TUI framework) installed
  • curl availability
  • TAS installation status (binary, source, or unknown)
  • TERMUX_APP_STORE_HOME in the wrapper script
  • packages/ directory presence

self-update

Updates the tasctl script itself from the latest version on GitHub.

tasctl self-update

help

Shows usage information.

tasctl help

Usage Notes

  • tasctl can be run from inside or outside the termux-app-store directory
  • If something behaves unexpectedly, run tasctl doctor before reporting a bug
  • The tasctl script self-updates independently from TAS itself

See Also

Clone this wiki locally