The orus command

Every orus command for installing and managing apps.

orus <command> [options]

`orus install`

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

Install an app from a folder, a .orusapp 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.

$ orus install ./notes

`orus remove`

orus remove <name>

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

$ orus remove notes

`orus purge`

orus purge <name>

Remove an app and the data it stored.

$ orus purge notes

`orus open`

orus open <name>

Start an installed app in its own window.

$ orus open notes

`orus rollback`

orus rollback <name>

Go back to the version before the last upgrade.

$ orus rollback notes

`orus list`

orus list [--json]

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

$ orus list

`orus search`

orus search [--json] [text]

Search the catalogs of your sources.

$ orus search notes

`orus update`

orus update

Refresh the catalogs of your sources.

`orus upgrade`

orus upgrade [--yes]

Install newer versions of the apps you have.

`orus sources`

orus sources list [--json]
orus sources add [--development] [--key FILE] [--name NAME] <url>
orus 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.

`orus catalog`

orus catalog keygen <name>
orus catalog build [--name NAME] [--key FILE] [--out DIR] <bundle folder>...
orus 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, orus 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	`~/.orus/apps/`
Your sources	`~/.orus/config/sources.toml`
System sources	`/etc/orus/sources.d/`