Niteshift CLI

Official command-line interface for Niteshift.

Installation

# One-off via npx (recommended)
npx niteshift@latest auth

# Or install globally
npm install -g niteshift
niteshift auth

The CLI is distributed through npm. Source access is private for now. See the Niteshift docs for product documentation.

Changelog

See the CHANGELOG for release notes.

Commands

Run niteshift <command> --help for the full set of options on any command.

Authentication

| Command | Description | | --- | --- | | niteshift auth | Authenticate with Niteshift via the browser | | niteshift auth status | Show authentication status | | niteshift auth logout | Clear authentication |

Tasks

| Command | Description | | --- | --- | | niteshift run [prompt] | Run a task in the current repository (opens $EDITOR when the prompt is omitted) | | niteshift list (alias ls) | List tasks for the current repository | | niteshift watch [taskId] | Watch a task's message stream in real time (interactive picker when omitted) | | niteshift prompt [taskId] [prompt] | Send a follow-up prompt to a running task (--steer redirects the active turn) | | niteshift interrupt [taskId] | Interrupt a task's active turn and clear queued prompts | | niteshift archive [taskIds...] | Archive one or more tasks | | niteshift unarchive [taskIds...] | Unarchive one or more tasks | | niteshift open [taskId] | Open a task in the browser |

Pickup

| Command | Description | | --- | --- | | niteshift pickup [taskId] | Pick up a task created in the UI and resume it locally (interactive picker when omitted) | | niteshift pickup all | Pick up all tasks for the current repository | | niteshift pickup last | Pick up the most recent task |

Terminal

| Command | Description | | --- | --- | | niteshift terminal | Manage terminal sessions (interactive picker) | | niteshift terminal new | Start a new terminal session | | niteshift terminal attach [taskId] | Attach to an existing terminal session |

Files

| Command | Description | | --- | --- | | niteshift cp <taskId>:<remotePath> <localPath> | Download a file from a remote sandbox | | niteshift cp <taskId> | Browse a sandbox filesystem interactively and download files | | niteshift cp browse <taskId> [startPath] | Browse a sandbox filesystem starting at a given path |

Help

| Command | Description | | --- | --- | | niteshift --help | Show all commands | | niteshift <command> --help | Show help for a specific command |