CLI Commands

Core Commands

niki watch

Monitor a command from start to finish.

niki watch [OPTIONS] -- <COMMAND>

Option	Description
--name, -n	Human-readable task name
--timeout, -t	Timeout in seconds
--quiet, -q	Suppress output

Examples:

niki watch -- python train.py
niki watch --name "Training" -- python train.py --epochs 100
niki watch --timeout 3600 -- ./long_job.sh

niki attach

Attach to an already-running process.

niki attach <PID> [OPTIONS]

Option	Description
--name, -n	Human-readable task name

Examples:

niki attach 12345
niki attach 12345 --name "Alignment job"

niki status

Show running and recent tasks.

niki status [OPTIONS]

Option	Description
--running, -r	Show only running tasks
--failed, -f	Show only failed tasks
--limit, -l	Maximum tasks to show

niki history

Query historical tasks.

niki history [OPTIONS]

Option	Description
--last	Time range (7d, 24h, 1w)
--name, -n	Filter by name pattern
--exit-code, -e	Filter by exit code
--limit, -l	Maximum tasks to show

Daemon Commands

niki daemon start

Start the background daemon.

niki daemon start [OPTIONS]

Option	Description
--foreground, -f	Run in foreground

niki daemon stop

Stop the running daemon.

niki daemon stop

niki daemon status

Check daemon status.

niki daemon status

Configuration Commands

niki config init

Run interactive configuration wizard.

niki config init

niki config show

Display current configuration.

niki config show

niki config path

Show configuration file path.

niki config path

Utility Commands

niki doctor

Check configuration and dependencies.

niki doctor

Validates:

• Config file exists
• Dependencies installed
• API key configured
• Daemon running

niki mode

Change notification mode.

niki mode <active|focus|meeting>

niki version

Show version.

niki version
niki --version
niki -V

Chat Commands

niki chat history

View chat history.

niki chat history [OPTIONS]

Option	Description
--platform	Filter by platform (telegram, slack)
--limit, -l	Maximum messages to show

niki chat stats

Show chat statistics.

niki chat stats

niki chat clear

Clear chat history.

niki chat clear --all --force