Registry / productivity / task-queue-tui

task-queue-tui

library1.0.6jsnpmunverified

A keyboard-driven, terminal-native task queue CLI tool that enforces single-task focus via a FIFO queue and integrated timer. Version 1.0.6, actively maintained on npm. Unlike bloated project management apps, it stores tasks in a local JSON file (~/.taskqueue/tasks.json) with zero infrastructure. Supports custom themes and task types. Requires Node 20+ and a terminal with 24-bit color support.

productivity devops

npm install task-queue-tui

package ↗

INSTALL

IMPORT

SIG · TASK-QUEUE-TUI

task-queue-tui

productivityjavascriptv1.0.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default export (package entry)

✓ import tq from 'task-queue-tui'

✗ const tq = require('task-queue-tui')

Package is ESM-only; CommonJS require will fail.

Types (TypeScript)

✓ import type { Task } from 'task-queue-tui'

✗ import { Task } from 'task-queue-tui'

Use 'import type' to avoid runtime inclusion; Task interface is exported from types.ts.

Theme type

✓ import type { Theme } from 'task-queue-tui'

✗ import { Theme } from 'task-queue-tui'

Theme type is available in TypeScript; avoid importing as value.

Launch the TUI with amber theme and custom task types. Press SPACE to pull the top task into focus mode, then use keybindings to manage your queue.

npx task-queue-tui --theme=amber --types="dev,review,meeting"

Debug

Known issues

gotchaRequires Node.js 20+ and a terminal with 24-bit color support.

fix

Ensure Node version >=20 and terminal supports truecolor (e.g., TERM=xterm-256color).

affects: >=1.0

gotchaTasks are stored in ~/.taskqueue/tasks.json; deleting this file removes all data.

fix

Backup the file before deletion: cp ~/.taskqueue/tasks.json ~/tasks_backup.json

affects: >=1.0

gotchaThe TUI is keyboard-driven; mouse support is not available. Some users try to click elements and fail.

fix

Use only keyboard commands as documented. Press 'q' to quit, 'Space' to pull task, etc.

affects: >=1.0

gotchaUsing require() or CJS imports will fail silently or throw errors.

fix

Use ES module imports. If using CommonJS, use dynamic import: import('task-queue-tui').then(m => m.default).

affects: >=1.0

Errors

Common errors & fixes

Error: Cannot find module 'task-queue-tui'

Package not installed globally or locally.

fix

Install globally: npm install -g task-queue-tui, or use npx: npx task-queue-tui

terminal does not support 24-bit color

Terminal emulator not configured for truecolor.

fix

Set TERM variable: export TERM=xterm-256color, or use a terminal that supports 24-bit color (e.g., iTerm2, Windows Terminal).

TypeError: task-queue-tui is not a function

Trying to import default export incorrectly or using require() with ESM package.

fix

Use proper ESM import: import tq from 'task-queue-tui'. If using CJS, use dynamic import.

Upgrade

Version history

1.0.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

packagetask-queue-tui ↗