# kern

> kern is a cross-platform desktop server manager (Tauri v2 + Rust + React).
> Register any project folder as a managed server instance, control its lifecycle,
> stream logs and telemetry, and extend it with plugins. Includes a command line
> (`kern-cli`), a loopback automation API, and an optional LAN web remote.
>
> these docs are also packaged as an agent skill: run `npx skills add ellipog/kern-web`
> (or `npm i -D @aaen-studios/kern`). full text in one response: /llms-full.txt

## docs

### Getting started
- [overview](https://kern.aaenz.no/docs/overview): what kern is, and where to go next.
- [getting started](https://kern.aaenz.no/docs/getting-started): download kern, register a folder, start an instance.

### Plugin development
- [manifest reference](https://kern.aaenz.no/docs/manifest-reference): the full manifest.json schema as a reference.
- [lifecycle](https://kern.aaenz.no/docs/lifecycle): start, stop, restart, install — commands and templating.
- [scaffold](https://kern.aaenz.no/docs/scaffold): starter files written into a fresh instance directory.
- [config schema](https://kern.aaenz.no/docs/config-schema): dynamic config forms the host renders for each instance.
- [plugin ui](https://kern.aaenz.no/docs/plugin-ui): shadow dom isolation, mount(), and the host api.
- [packaging](https://kern.aaenz.no/docs/packaging): building a .kern file and seeding it for development.
- [distribution](https://kern.aaenz.no/docs/distribution): how to publish a plugin to the registry.
- [plugin security](https://kern.aaenz.no/docs/plugin-security): permissions, install consent, checksums — and what is not sandboxed.

### Using kern
- [cli reference](https://kern.aaenz.no/docs/cli): kern-cli — every command, flag, exit code, and the dashboard.
- [web remote](https://kern.aaenz.no/docs/web-remote): the full kern panel in a browser — console, files with a real editor, backups, schedules, plugins. lan over https, or anywhere via cloudflare tunnel.
- [backups](https://kern.aaenz.no/docs/backups): world snapshots — schedules, retention, restore, and pre-update safety.
- [scheduled tasks](https://kern.aaenz.no/docs/tasks): interval, daily, and cron tasks — restart, backup, command, health.
- [monitoring & alerts](https://kern.aaenz.no/docs/monitoring): telemetry, metric history, health alerts, crash reports, energy.
- [notifications & webhooks](https://kern.aaenz.no/docs/notifications): native toasts, discord/slack webhooks, and regex log alerts.
- [keyboard shortcuts](https://kern.aaenz.no/docs/shortcuts): every keyboard shortcut in the app and the cli dashboard.
- [troubleshooting](https://kern.aaenz.no/docs/troubleshooting): symptom → cause → fix, from install to stuck servers.
- [recipes](https://kern.aaenz.no/docs/recipes): copy-paste setups — backups, alerts, deploys, overnight restarts.
- [ai agents](https://kern.aaenz.no/docs/ai-agents): install kern's docs as an agent skill so coding agents write plugins instead of guessing.

### Automation
- [automation api](https://kern.aaenz.no/docs/automation-api): the loopback JSON api — every endpoint, auth, and streaming events.

### Reference
- [config.json](https://kern.aaenz.no/docs/config-json): the host's registry file — every setting and instance field.
- [faq](https://kern.aaenz.no/docs/faq): short answers to the questions that come up first.
- [glossary](https://kern.aaenz.no/docs/glossary): the words kern uses, in one place.
- [security model](https://kern.aaenz.no/docs/security): what is trusted, what is exposed, and where secrets live.

### Architecture
- [architecture](https://kern.aaenz.no/docs/architecture): process model, storage layout, and the background workers.

## raw markdown
- [overview](https://kern.aaenz.no/raw/docs/overview)
- [getting started](https://kern.aaenz.no/raw/docs/getting-started)
- [manifest reference](https://kern.aaenz.no/raw/docs/manifest-reference)
- [lifecycle](https://kern.aaenz.no/raw/docs/lifecycle)
- [scaffold](https://kern.aaenz.no/raw/docs/scaffold)
- [config schema](https://kern.aaenz.no/raw/docs/config-schema)
- [plugin ui](https://kern.aaenz.no/raw/docs/plugin-ui)
- [packaging](https://kern.aaenz.no/raw/docs/packaging)
- [distribution](https://kern.aaenz.no/raw/docs/distribution)
- [plugin security](https://kern.aaenz.no/raw/docs/plugin-security)
- [cli reference](https://kern.aaenz.no/raw/docs/cli)
- [web remote](https://kern.aaenz.no/raw/docs/web-remote)
- [backups](https://kern.aaenz.no/raw/docs/backups)
- [scheduled tasks](https://kern.aaenz.no/raw/docs/tasks)
- [monitoring & alerts](https://kern.aaenz.no/raw/docs/monitoring)
- [notifications & webhooks](https://kern.aaenz.no/raw/docs/notifications)
- [keyboard shortcuts](https://kern.aaenz.no/raw/docs/shortcuts)
- [troubleshooting](https://kern.aaenz.no/raw/docs/troubleshooting)
- [recipes](https://kern.aaenz.no/raw/docs/recipes)
- [ai agents](https://kern.aaenz.no/raw/docs/ai-agents)
- [automation api](https://kern.aaenz.no/raw/docs/automation-api)
- [config.json](https://kern.aaenz.no/raw/docs/config-json)
- [faq](https://kern.aaenz.no/raw/docs/faq)
- [glossary](https://kern.aaenz.no/raw/docs/glossary)
- [security model](https://kern.aaenz.no/raw/docs/security)
- [architecture](https://kern.aaenz.no/raw/docs/architecture)