Skip to content

hridaya423/lexis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Apr 22, 2026
e812f1e · · Apr 22, 2026

History

32 Commits
Apr 15, 2026
Apr 15, 2026
Apr 22, 2026
Mar 31, 2026
Apr 20, 2026
Apr 14, 2026
Mar 31, 2026
Mar 31, 2026
Apr 16, 2026
Mar 31, 2026
Mar 31, 2026
Apr 10, 2026
Apr 14, 2026
Mar 31, 2026
Mar 31, 2026

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 versionsns

Examples in lx mode:

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

Everyday Commands

lx doctor
lx config show
lx config set-model l model-id>gt;
lx config set-hook-mode auto
lx config set-hook-mode lx
lx hooks uninstallall

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