Contribute

Start contributing.

Good first issues, straight from the repo. Pick one, comment to claim it, and open a PR. The project is GPL-2.0 and the whole OS — daemons, shell, apps, image pipeline — lives in one monorepo.

Good first issues

No open “good first issue” tickets right now — check all issues or open one.

Get set up

git clone https://github.com/Lisa-AgenticOS/lisa-os.git && cd lisa-os
git config core.hooksPath .githooks   # pre-push hook runs the lint gate
just build                            # cargo build --workspace
just lint && just test                # the CI gate — run before every commit

The Rust workspace builds and tests on macOS and Linux; image and systemd/portal work is Linux-only and runs in CI. Read the component's spec section in docs/PLAN.md before touching it — component READMEs mirror their spec.

Where to look

All issues

The full tracker — bugs, features, and milestone work.

Working agreements

The operating manual: commands, component map, the rules.

The plan

Architecture and scope — the source of truth.

Status

The living "where are we" snapshot — read it first to catch up.