applaunch

A TUI application launcher for terminal apps, written in Go.

Quick Install

curl -sSL https://raw.githubusercontent.com/slowmove/applaunch/main/install.sh | bash

Supports: macOS (Intel/Apple Silicon), Linux (x86_64, arm64)

Features

• Browse and launch TUI applications
• Fuzzy search as you type
• Favorites with ★ marker at the top
• Quick launch with number keys 1-9
• Modal dialogs for managing entries
• Dark theme optimized for terminal use
• Automatic background updates

Usage

# Launch the application
applaunch

# Check for updates
applaunch --update

# Show version
applaunch --version

Controls

Key	Action
↑ / ↓ or j / k	Navigate through the list
Enter	Launch the selected application
1 - 9	Quick launch favorites
Ctrl+f	Toggle favorite
Ctrl+a	Add new entry (opens modal)
Ctrl+e	Edit entry (opens modal with current values)
Ctrl+d	Delete entry (opens modal)
Esc / Ctrl+c	Exit
Backspace	Delete character in search

Configuration

The config file is at ~/.config/applaunch/config.yaml:

entries:
  - name: "lazygit"
    command: "lazygit"
    description: "TUI for git"
    favorite: true

  - name: "jira (user mode)"
    command: "jiratui -u"
    description: "Jira TUI in user mode"
    favorite: false

Configuration Options

Option	Description
name	Display name
command	Command to execute (with optional arguments)
description	Optional description
favorite	Show at top with ★ (true/false)

Updating

# Check for and download updates
applaunch --update

# Run applaunch again to apply the update
applaunch

Or reinstall to update:

curl -sSL https://raw.githubusercontent.com/slowmove/applaunch/main/install.sh | bash

First Launch

On first launch with an empty config, you'll be prompted to add example apps.

Platform Support

Platform	Architectures	Install Command
macOS	x86_64, arm64	`curl -sSL https://raw.githubusercontent.com/slowmove/applaunch/main/install.sh
Linux	x86_64, arm64	`curl -sSL https://raw.githubusercontent.com/slowmove/applaunch/main/install.sh

Development

Building from Source

# Clone the repository
git clone https://github.com/slowmove/applaunch.git
cd applaunch

# Build the application
go build -o applaunch .

# Run tests
go test ./...

# Build a release
goreleaser release --snapshot

Release Process

To create a new release:

# Update version if needed
# Create a git tag
git tag v0.1.0
git push origin v0.1.0

GitHub Actions will automatically build and upload binaries for all platforms.

Tech Stack

• bubbletea - TUI framework
• lipgloss - Style library

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and feature requests, please use the GitHub Issues page.