whatisgithub

What is lookingglass?

s1gil0/lookingglass — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 4/5Setup · moderate

In one sentence

Looking Glass is a local AI coding CLI built around persistent, schedulable sessions: it saves full conversation and workspace state so scheduled AI turns can resume work, run tests, and fix issues automatically.

Mindmap

mindmap
  root((looking glass))
    What it does
      Persistent AI coding CLI
      Scheduled AI turns
      Worker agents
    Tech stack
      TypeScript
      Node.js
      SQLite
    Use cases
      Resume sessions later
      Auto follow up on tests
      Parallel worker agents
    Requirements
      Linux or Windows only
      Node.js 22.19+
      ripgrep on PATH

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an AI coding session alive across scheduled check-ins instead of starting a fresh chat each time.

USE CASE 2

Automatically follow up on a deployment or test run and have the AI fix failures it finds.

USE CASE 3

Run multiple AI worker agents with different models in parallel on separate parts of a task.

What is it built with?

TypeScriptNode.jsSQLite

How does it compare?

s1gil0/lookingglass4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node.js 22.19+, ripgrep on PATH, and a running OpenAI-compatible model gateway like LM Studio, Linux or native Windows only.

No license file is mentioned in the available README excerpt, so usage rights are unclear, check the repository directly.

So what is it?

Looking Glass is a command line tool for coding with a local AI assistant, designed around sessions that can persist and continue working even after you close the terminal. Instead of treating each AI conversation as a one-off chat, Looking Glass saves the full conversation, tool history, and workspace state to a local SQLite database, so a session can be reopened later and continue exactly where it left off. The standout feature is its built-in scheduler. You can schedule a session to wake up later and take another AI turn automatically, for example to check whether a deployment finished, follow up on test results and fix failures, run a recurring code review, or continue debugging after new logs appear. These scheduled turns are not separate stateless jobs, they can inspect files that changed, run commands, edit code, and write results back into the same ongoing session. The scheduler runs as a background service independent of the terminal, using systemd on Linux and Task Scheduler on Windows. Looking Glass works with an interactive terminal chat interface as well as one-shot command line prompts, and it can run multiple worker agents concurrently, each with its own model and reasoning settings, so a stronger model can coordinate work while cheaper or faster models handle parallel tasks. It connects to any OpenAI-compatible model gateway, including LM Studio running locally or other compatible servers, rather than requiring a specific cloud AI provider. The tool is built for a single local operator rather than as a hosted or multi-user service. It requires Linux or native Windows, Node.js version 22.19.0 or newer, and the ripgrep search tool available on your system path, macOS is not currently supported. It can be installed globally through npm, or built from source by cloning the repository and running the project's build scripts. Configuration, including which model and gateway to use, is controlled through a JSON or JSONC settings file that can be set globally or per project.

Copy-paste prompts

Prompt 1
Help me configure Looking Glass to connect to my local LM Studio server as the gateway.
Prompt 2
Set up a scheduled Looking Glass session that reruns my test suite every morning and reports failures.
Prompt 3
Explain how Looking Glass's persistent sessions differ from a normal stateless AI chat.
Prompt 4
Walk me through installing Looking Glass from source on Windows using PowerShell.

Frequently asked questions

What is lookingglass?

Looking Glass is a local AI coding CLI built around persistent, schedulable sessions: it saves full conversation and workspace state so scheduled AI turns can resume work, run tests, and fix issues automatically.

What language is lookingglass written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, SQLite.

What license does lookingglass use?

No license file is mentioned in the available README excerpt, so usage rights are unclear, check the repository directly.

How hard is lookingglass to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is lookingglass for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.