Skip to content

Repository files navigation

Lexis

Lexis is a local-first terminal assistant: install once, then type natural language in your shell.

No special prefix required. Just type things like:

  • check if brew is installed
  • install pnpm
  • show node and npm versions

Install

macOS / Linux:

curl -fsSL https://lexis.hridya.tech/install.sh | bash

Windows (PowerShell):

iwr https://lexis.hridya.tech/win.ps1 -useb | iex

If you self-host the website, these endpoints are served directly by the app:

  • /install.sh
  • /win.ps1

The installer sets up local inference runtime, writes config, and installs shell hooks. Runtime selection is automatic:

  • macOS (Apple Silicon): MLX
  • macOS (Intel): llama.cpp
  • Linux + NVIDIA: vLLM
  • Linux CPU-only: llama.cpp
  • Windows: llama.cpp

You do not need npm to use Lexis after installation.

During setup, Lexis asks how you want to use it:

  • auto: route natural-language commands directly in terminal
  • lx: only run when you explicitly call lx ...

How It Works After Install

  1. Open a new terminal.
  2. If you chose auto, type normal English directly.
  3. If you chose lx, prefix commands with lx.
  4. Higher-risk actions ask for confirmation.

Examples in auto mode:

check if brew is installed
install pnpm
show node and npm versions

Examples in lx mode:

lx check if brew is installed
lx install pnpm
lx show node and npm versions

Everyday Commands

lx doctor
lx config show
lx config set-model <model-id>
lx config set-hook-mode auto
lx config set-hook-mode lx
lx hooks uninstall

Safety

  • Risk is model-driven.
  • Low-confidence plans require confirmation.
  • Critical plans require double confirmation before execution.
  • Planning always includes detected platform/shell context, so Windows and Unix commands can differ.

Web Retrieval (No API Key Required)

Lexis uses MCP web search by default and can pull page content into model context when needed.

Session Controls

In a hooked shell:

  • exit disables Lexis for the current terminal session (instead of closing your shell).
  • uninstall (no args) removes Lexis hooks, package, runtime venv, and configured model cache.
  • You can also run lx uninstall --yes.

For full command options, run:

lx --help

Releases

Packages

Contributors

Languages