CLI Reference

Everything you need to know about the Praxl command-line interface.

Installation

npm install -g praxl-app

Requires Node.js 18 or later. After installing, run praxl --version to verify.

Commands

Command	Description
scan	Discover existing skills across all supported platform directories.
connect	Authenticate, import discovered skills, and start syncing.
sync	Run a one-time or continuous sync between cloud and local directories.
import	Import skills from a directory or file into your Praxl library.
status	Show the current sync state, connected platforms, and any pending changes.
login	Authenticate with your Praxl account interactively or via token.

praxl scan

Discover existing skills across all supported platform directories.

praxl scan [--platforms claude,cursor]

--platforms	Comma-separated list of platforms to scan (default: all)
--json	Output results as JSON

praxl connect

Authenticate, import discovered skills, and start syncing.

praxl connect

--token	Use a CLI token instead of interactive login
--platforms	Limit import to specific platforms

praxl sync

Run a one-time or continuous sync between cloud and local directories.

praxl sync [--watch] [--interval 30]

--watch	Keep running and watch for file changes
--interval	Polling interval in seconds (default: 30)
--platforms	Sync only specific platforms
--json	Output sync results as JSON

praxl import

Import skills from a directory or file into your Praxl library.

praxl import ./my-skills/

--tag	Add a tag to all imported skills
--json	Output import results as JSON

praxl status

Show the current sync state, connected platforms, and any pending changes.

praxl status

--json

Output status as JSON

praxl login

Authenticate with your Praxl account interactively or via token.

praxl login [--token YOUR_TOKEN]

--token	Authenticate non-interactively using a CLI token
--url	Override the API base URL (for self-hosted setups)

Global Options

These flags can be passed to any command.

Flag	Description
--token	CLI authentication token (overrides stored token)
--url	API base URL (default: https://go.praxl.app)
--platforms	Comma-separated platform filter
--interval	Sync polling interval in seconds
--json	Output machine-readable JSON for all commands

Configuration Files

The CLI stores configuration in the ~/.praxl/ directory.

File	Purpose
~/.praxl/token	Stored authentication token (created by praxl login)
~/.praxl/config.json	User preferences - default platforms, sync interval, API URL
~/.praxl/sync-state.json	Tracks last-synced timestamps and file hashes for each platform

Daemon Mode

Running praxl sync --watch starts the CLI in daemon mode. It watches your local skill directories for changes and polls the cloud at the configured interval. When a change is detected on either side, the daemon syncs automatically - no manual intervention needed.

You can run the daemon in the background with your system's process manager or simply leave a terminal tab open. The default polling interval is 30 seconds; adjust it with --interval.

Getting Your CLI Token

If you prefer non-interactive authentication (CI/CD pipelines, remote servers), generate a CLI token from the Settings page in the web app at go.praxl.app. Copy the token and pass it to the CLI:

praxl login --token YOUR_TOKEN

The token is saved to ~/.praxl/token and used for all subsequent commands. You can also pass it per-command with the global --token flag.