PenterDocumentationPenter CLI. Your workflow, in the terminal.
PENTER / Terminal

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.

01 · Overview

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.

02 · Requirements

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.

If penter is not recognized
Close and reopen CMD or PowerShell after installation to pick up the updated PATH. The bundled CLI is available in Windows installers containing this integration; older installers will not have it. Windows 11 Explorer may place Penter actions under “Show more options”.

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.

03 · Quick start

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.

Local AI — Ollama
ollama serve
ollama pull qwen2.5-coder:7b
Windows CMD / PowerShell — installed Penter
penter
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" --json

For 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.

Local workspace tools
penter agent "Explain the auth flow" --workspace .
penter review "Review correctness and security" --workspace .
penter agent "Improve error handling" --workspace . --allow-writes
Development checkout only
In a source checkout, npm run cli -- doctor andnpm run cli -- tui --workspace .remain supported. The examples above are for the Windows CLI installed on PATH.
04 · Desktop

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.

Windows — CLI and Desktop
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.

05 · Safety & limits

What CLI does — and does not — do

CLI is not the desktop pentest executor
Ask, Plan and Chat do not execute commands. The local coding agent only accesses bounded workspace files; it cannot run shell, scans, browser automation, Docker, WSL or MCP tools. CLI does not inherit Desktop engagement scope or approvals. Use Desktop for supported authorized testing workflows.

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 Desktop
Next step

Ready to get started?

Follow the setup guide, install the current approved Desktop release, and connect your account.