Skip to content

lxask 1.0.0

Choose a tag to compare

@arxhr007 arxhr007 released this 24 Oct 23:41
· 29 commits to main since this release

lxask 1.0.0

Ask in plain English, get a Linux command checked against the man pages. It runs on your
machine: no network, account or API key after installing. One 1.1 GB install, about 1.3 GB
of memory while answering.

What 1.0 means

The command-line options, the settings file (~/.local/share/lxask/settings), the files
the installer puts on disk and the answer format are now stable. Changes that would break
them wait for 2.0.

Highlights

  • Explains every part of the command, splits multi-step requests, keeps restrictions
    ("without lsof", "don't use sudo"), and asks back when a request is vague.
  • Checks every program and option against the manual and flags what it can't confirm;
    warns before anything that deletes, overwrites or formats. It never runs a command for you.
  • Ctrl+G in bash and zsh (lxask --shell-init), a server mode that keeps the model loaded
    (answers in about 2 s), --command-only for scripts, --bad / --share for reports.
  • Linux x86_64 (with a v3 build) and arm64. The model files are also on Hugging Face.

Measured

On the public NL2SH-ALFA
test set (300 shell tasks, each answer run in Docker by the InterCode-ALFA harness):

solved 95% CI
lxask 187/300 (62%) 57-68%
the untuned Qwen2.5-Coder-1.5B it was trained from 92/300 (31%) 26-36%

On the 237 tasks with no overlap with its training sources: 61% against 34%
(McNemar p < 10⁻¹³). Retries and retrieval were measured to make no difference on this
set; the score is the fine-tune's.

Where it misses, and every measurement with intervals and caveats:
docs/accuracy.md, docs/examples.md.

Install

curl -fsSLO https://github.com/arxhr007/lxask/releases/latest/download/install.sh
sh install.sh

Checksums are in SHA256SUMS. Offline install and upgrade: docs/install.md.

Licence

Code MIT. Model: a fine-tune of Qwen2.5-Coder-1.5B-Instruct (Apache 2.0). Training data
and documentation index licences: NOTICE.