Documentation

Loccle is a Rust-powered CLI and TUI coding assistant built for fast builders. It integrates directly with your project workspace to read files, run tests, apply changes, and assist you dynamically via AI agents. Let Loccle handle technical boilerplate while you code.

Installation

Get Loccle installed on your system. You can choose either the global CLI or download a standalone desktop binary.

Install via NPM (Recommended)

Make sure you have Node.js installed. Install the Loccle CLI globally using:

npm install -g loccle

Desktop Installer (Tauri Client)

Standalone GUI installers are available for various platforms:

  • Windows: Download the executable (.exe) installer.
  • macOS: Available for both Apple Silicon (arm64) and Intel (x64) architectures.
  • Linux: Standalone Debian package (.deb) or Fedora package (.rpm) installer.

CLI Commands

Use commands directly inside the TUI chatbox input to control the assistant session.

CommandDescription
/effortSet reasoning effort (default, low, medium, high).
/modelSwitch active AI models from the available models list.
/newCreate a new coding thread/session in the current workspace.
/sessionsOpen modal to view and switch between previous workspace threads.
/topupOpen top-up modal to replenish token credits wallet.
/logoutSafely sign out from the current dashboard session.

Keyboard Shortcuts

Interact with the terminal UI efficiently using standard hotkeys.

ShortcutAction
EnterSubmit input, select lists, or confirm choices.
EscClose modal, cancel search/suggestions, or exit.
Up / Down ArrowsNavigate command suggestions, select lists, or scroll text.
Left / Right ArrowsMove the typing cursor or navigate modal buttons.
TabAutofill active command suggestions.
PageUp / PageDownScroll the chat viewport pages.

FAQ

What is vibe coding?

Vibe coding focuses on high-level architecture and developer momentum. You instruct the AI assistant to perform edits, checks, and runs, while you guide the architectural decisions without getting bogged down by syntax.

How does Loccle handle billing?

Loccle operates on a credit-based model. You pay only for the exact prompt and completion tokens you consume. You can track your usage and top up your wallet directly inside the dashboard.