Skip to main content

Installation

Prerequisites​

  • Node.js 20+
  • npm 10+
  • macOS/Linux/Windows terminal

Install Globally​

npm i -g @telepat/ideon

Verify the CLI​

ideon --help

First-Time Setup​

ideon settings

Optional: Run From Source (Contributor Workflow)​

git clone https://github.com/telepat-io/ideon.git
cd ideon
npm install
npm run build
npm link
ideon --help

Common Setup Issues​

  • keytar build/runtime issues: ensure system keychain APIs are available and Node is supported
  • Missing Node version: switch to Node 20+ (for ESM + tooling compatibility)
  • Permission issues writing output: override output directories in settings or environment vars