Penter CLI. Your workflow, in the terminal.
Prefer the terminal? After installing Penter for Windows, run penter in CMD or PowerShell for the local AI chat TUI. Use penter desktop whenever you need the full workspace.
A lightweight, local-first alternative
Use Penter CLI to ask technical questions, develop a plan, chat in the full-screen terminal UI and review a local workspace with two independent read-only reviewers. The CLI uses local Ollama; it does not need to open Electron or sign in to Penter Cloud.
Ask & Plan
Non-executing AI responses and structured planning.
Chat
Interactive terminal conversations with optional local sessions.
Code review
Bounded local workspace inspection and two independent reviewers.
Install once, run from any terminal
Install a Windows build of Penter that includes CLI integration, then open a new Command Prompt or PowerShell window. The installer bundles the CLI's Node.js runtime and addspenterto your user PATH. You do not need to install Node.js separately for the packaged CLI. Install and start Ollama locally to use the AI commands.
Working directly from the private source checkout instead? That still requires Node.js 22+ and dependencies installed in the repository. Use npm run cli -- ornpm linkto expose a local penter command. The installed Windows launcher is a separate distribution path.
Use penter in CMD or PowerShell
Start Ollama, pull a local model, and open a new Windows terminal. Runningpenterwithout arguments launches the branded, full-screen chat TUI in your current directory.
ollama serve
ollama pull qwen2.5-coder:7bpenter
penter doctor
penter models
penter tui --workspace .
penter chat --session lab-notes
penter ask "Explain this CVE without testing a target"
penter plan "Audit my app's auth flow" --jsonFor local code inspection, choose a workspace folder explicitly. These commands are read-only by default. To let the agent propose edits, use --allow-writes; each file change still requires interactive operator approval.
penter agent "Explain the auth flow" --workspace .
penter review "Review correctness and security" --workspace .
penter agent "Improve error handling" --workspace . --allow-writesnpm run cli -- doctor andnpm run cli -- tui --workspace .remain supported. The examples above are for the Windows CLI installed on PATH.Switch between terminal and desktop
Use the same Penter installation for both interfaces. From a Windows terminal,penter desktopopens the Electron app. Pass a folder to request opening that workspace; Desktop asks you to confirm it in the native folder picker before granting access.
penter
penter desktop
penter desktop .You can also right-click a folder or folder background in Explorer and choose Open with Penter → Penter CLI or Penter Desktop. On Windows 11, use “Show more options” if the menu is hidden. For development checkouts, launch Electron with npm run electron:dev instead.
What CLI does — and does not — do
CLI sessions are opt-in and saved as plaintext locally. Avoid putting secrets or customer information in prompts or saved sessions. Installing the Windows CLI does not grant it Desktop scanning or execution permissions.
Need the full workspace? Download Penter DesktopReady to get started?
Follow the setup guide, install the current approved Desktop release, and connect your account.