Getting started

Run without installing

With Nix and flakes enabled:

nix run github:nerima-lisp/loom

Pass a file or directory after -- to open a specific starting path:

nix run github:nerima-lisp/loom -- path/to/file.lisp

Install

nix profile install github:nerima-lisp/loom/v0.1.0
loom

Consumers inside the nerima-lisp organization should pin a reviewed commit or release tag rather than following the default branch:

# flake.nix
inputs.loom = {
  url = "github:nerima-lisp/loom/v0.1.0";
  inputs.nixpkgs.follows = "nixpkgs";
};

First steps

Start loom with an optional starting directory for the file-tree sidebar:

loom
loom ~/project

C-x C-t toggles the file-tree sidebar; C-x C-f prompts for a path and opens it in the selected window; C-x C-s saves the selected buffer; C-x C-c quits. The full command catalogue is maintained in src/application/command-definitions.lisp.

C-x r provides named registers, C-x ( and C-x ) record keyboard macros, and C-u, M-0 … M-9, and M-- apply numeric prefixes to the next command.

Build from source

loom builds with SBCL and ASDF. The supported path is Nix. See the development guide for source builds, the test suite, PTY checks, coverage, and the REPL workflow.