The kilne command

Every kilne command for installing and managing apps.

kilne <command> [options]

`kilne install`

kilne install [--yes | --allow CAP,CAP] [--sha256 HASH] <folder | file.kilneapp | https://URL | name[@version]>

Install an app from a folder, a .kilneapp file, a URL, or a name in a catalog. It shows what the app asks for and asks before it installs. Add --yes to skip the question, or --allow with a list of capabilities to refuse an app that asks for more.

$ kilne install ./notes

`kilne remove`

kilne remove <name>

Remove an app and its earlier version. Its data is kept.

$ kilne remove notes

`kilne purge`

kilne purge <name>

Remove an app and the data it stored.

$ kilne purge notes

`kilne open`

kilne open <name>

Start an installed app in its own window.

$ kilne open notes

`kilne rollback`

kilne rollback <name>

Go back to the version before the last upgrade.

$ kilne rollback notes

`kilne list`

kilne list [--json]

List installed apps. Add --json for machine-readable output.

$ kilne list

`kilne search`

kilne search [--json] [text]

Search the catalogs of your sources.

$ kilne search notes

`kilne update`

kilne update

Refresh the catalogs of your sources.

`kilne upgrade`

kilne upgrade [--yes]

Install newer versions of the apps you have.

`kilne sources`

kilne sources list [--json]
kilne sources add [--development] [--key FILE] [--name NAME] <url>
kilne sources remove|enable|disable <name>

See, add, remove, turn on and turn off the sources apps come from. A development source is for your own catalog while you build.

`kilne catalog`

kilne catalog keygen <name>
kilne catalog build [--name NAME] [--key FILE] [--out DIR] <bundle folder>...
kilne catalog serve [--port N] [--bind ADDR] <folder>

Tools for hosting your own catalog: make a key pair, build a catalog from app bundles, and serve a folder while you test.

What you see when you install

Before anything is written, kilne install prints the app's name, version and id, where it comes from, whether it is new or replaces a version, and the capabilities it asks for. Then it asks Install? [y/N].

When you upgrade an app and it asks for something new, that capability is marked (new).

Where things live

What	Where
Installed apps	`~/.kilne/apps/`
Your sources	`~/.kilne/config/sources.toml`
System sources	`/etc/kilne/sources.d/`