TypeScript definitions and utilities for FocusAny.
npm install focusany-sdkThe SDK now provides a unified command-line interface through the focusany command.
npx focusany <command> [options]Available commands:
release-prepare: Check and update config.json for production releasecli: Forward commands to the locally installed FocusAny CLIstatus: Check the local FocusAny environment (app, CLI binary, service)version: Display the current version of FocusAny SDKhelp: Show help information
The cli command finds the real FocusAny CLI installed on your machine and
forwards all arguments to it — useful while developing plugins, without
installing the CLI separately.
npx focusany cli plugin list
npx focusany cli doctor
npx focusany cli mcp toolsThe CLI binary is located in this priority order:
--cli <path>explicit overrideFOCUSANY_CLIenvironment variablefocusanyonPATH- Common install locations (
~/.focusany/bin,~/.local/bin,/usr/local/bin,/opt/homebrew/bin,dist-cli/of the current project)
The status command diagnoses the local FocusAny setup:
npx focusany statusIt reports whether the FocusAny desktop app is installed, where the CLI binary was found, the data root directory, and whether the FocusAny service is running. Exits non-zero when any check fails.
npx focusany release-prepareThis will check dist/config.json in your current directory.
npx focusany release-prepare path/to/your/config.jsonThis command will:
- Look for the specified config file (or
dist/config.jsonby default) - Check if
development.envis set to"dev" - Automatically change it to
"prod"if needed - Display appropriate messages about the changes made
Release Prepare - Default config file:
npx focusany release-prepareRelease Prepare - Custom config file:
npx focusany release-prepare build/config.json
npx focusany release-prepare src/configs/app-config.jsonVersion Command:
npx focusany versionnpm run buildThis will build both the shim files and the CLI tools.
npm run build:clinpm run build:shimApache-2.0