tabstax-cli

Hey CLI - TabStax Command Line Interface

A conversational CLI for managing your Next Actions directly from the terminal. Works with the TabStax browser extension.

Installation

npm install -g tabstax-cli

Quick Start

# Login to your TabStax account
hey login

# Set your default project
hey use "My Project"

# Add a next action
hey "Build the login page"

# Add a breadcrumb (completed action)
hey -x "Fixed the auth bug"

# List your actions
hey ls

# Mark action #1 as done
hey done 1

Commands

Actions

Command	Description
hey "message"	Add a next action
hey -x "message"	Add a breadcrumb (past tense, already done)
hey done [n]	Mark action #n as complete (default: #1)
hey rm <n>	Remove action #n
hey edit <n> "text"	Edit action #n content
hey mv <from> <to>	Move action to different position

Listing

Command	Description
hey ls	List actions for current project
hey ls stax	List all your stax with priorities
hey ls --all	Expanded view with actions per stax
hey ls --done	Show breadcrumbs only

Projects & Priority

Command	Description
hey use <project>	Set default project (fuzzy matched)
hey pri <project> <level>	Set priority: must, should, good, meh
hey which	Show current context

Authentication

Command	Description
hey login	Log in to TabStax
hey logout	Log out
hey whoami	Show current user
hey status	Show CLI status

Features

• 7-action limit per project to maintain focus (bypass with --force)
• Fuzzy project matching - hey use tab matches "TabStax"
• Priority icons - ★ must, ◆ should, ○ good, · meh
• Breadcrumbs - Track what you've done, not just what's next
• Syncs with extension - Changes appear in TabStax browser extension instantly

Examples

# Quick workflow
hey use "insurance"
hey "Call agent about claim"
hey "Upload documents"
hey -x "Submitted form 1099"
hey done 1
hey ls

# See all projects
hey ls stax

# Set project as high priority
hey pri "insurance" must

# Force add when at limit
hey "One more thing" --force

Requirements

• Node.js 18+
• TabStax account (free or paid)

Links

• TabStax Extension
• GitHub
• Issues

License

MIT