lux

KO | EN

gitlite — search

#javascript #typescript #llm #golang #docker #macos #nodejs #java #windows #kubernetes #awesome-list #vue #pytorch #openai

(★ 10)

an OS-level observation program to shed some light on your AI agents

lux 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Lux

Welcome to Lux! The blackbox for your ai agents. 
An easy, automatic way to store everything your agents have done.

For when you want to:
- find that old conversation you forgot about 
- figure out what your agent has done while you weren't watching
- provide your current agent session a comprehensive ledger of state changes

## About

Lux is an OS‑level observation system for third‑party agents: it runs the agent in a container, uses auditd + eBPF inside the Docker Desktop VM to capture exec/fs/network/IPC metadata, and correlates that into a session‑tagged timeline. The stack includes a harness (PTY + API), a collector pipeline (filter → summary → merge), a dedicated container to run the agent, and a UI for log review.

## Install (beta)
```
Run the versioned installer & setup wizard:
```bash
VERSION=vX.Y.Z
curl -fsSL "https://raw.githubusercontent.com/scottmaran/lux/${VERSION}/install_lux.sh" | bash -s -- --version "${VERSION}" --setup
```

## Run-scoped logs
Each `lux up` creates a new run directory under `paths.log_root`, for example:

```text
<trusted_root>/logs/
  lux__2026_02_12_12_23_54/
    collector/raw/
    collector/filtered/
    harness/sessions/
    harness/jobs/
    harness/labels/
```

`lux logs tail` and `lux jobs ...` default to the active run. If no run is
active, use `--run-id <id>` or `--latest`.

## Lux CLI (beta)
The recommended way to run the stack is via the `lux` CLI, which pulls the
versioned Docker images from GHCR and manages config + compose wiring.

`lux setup` can optionally enable shims and optionally start collector + UI right away. If shims are enabled, just run `codex` or `claude` like you normally would and sessions will be logged to the directory chosen in setup.

If `lux` is "command not found" after install, ensure `~/.local/bin` is in your `PATH`.
For plain-language concepts and first-run command tracks, run `lux info`.

To view more info about user configs, see `docs/contracts/config.md`.
To view more info about the cli, see `docs/contracts/cli.md`.

Temporary support note (February 2026): 
- Linux host runtime support is temporarily not guaranteed while bind-mount permission compatibility work is in progress. The currently recommended host is macOS with Docker Desktop.
- For subscription-based Claude Code sessions on MacOS, you need to log in upon starting the TUI
See platform support/caveats: `docs/contracts/platform.md`.

## Docs
Start with the user guide in `docs/contracts/`.
Developers/contributors: see `docs/README.md` for the full documentation map.

## License
Licensed under the GNU Affero General Public License v3.0 only (`AGPL-3.0-only`).
See `LICENSE`.

lux

lux 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

lux

lux 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README