mirror of https://github.com/urbit/shrub.git synced 2024-12-26 05:23:35 +03:00

History

Fang 059fb9e1ee dbug: fix dashboard for the softdist age We can no longer rely on landscape to be installed and serving a channel.js, so we bring our own. App discovery works through gall now. We can only ask per desk though, so we still need to talk to clay for the set of desks.		2021-09-26 14:21:54 +04:00
..
app	dbug: fix dashboard for the softdist age	2021-09-26 14:21:54 +04:00
gen	+agents generator	2021-09-25 16:15:55 -04:00
lib	kiln: don't merge %kids from random desks	2021-09-26 01:07:45 -04:00
mar	base-dev,arvo: update marks, add %ship mark	2021-09-21 14:51:57 +10:00
sur	various: update symbolic merges	2021-09-17 14:54:01 +10:00
sys	clay: fix failure to load apps	2021-09-26 00:26:37 -04:00
ted	various: fix dependencies & tests	2021-09-17 14:51:19 +10:00
tests	eyre: update tests wrt recent changes	2021-09-25 17:16:39 +04:00
.gitattributes
.ignore
desk.bill	arvo: start %herm by default	2021-09-20 14:43:59 +10:00
LICENSE.txt
README.md	readme: update arvo maintainers list	2021-03-25 23:52:20 +01:00
sys.kelvin	added /sys.kelvin and %kelvin mark	2021-06-28 17:07:13 -04:00
TESTING.udon

README.md

Arvo

A clean-slate operating system.

Usage

To run Arvo, you'll need Urbit. To install Urbit and run Arvo please follow the instructions in the getting started docs. You'll be on the live network in a few minutes.

If you're doing development on Arvo, keep reading.

Documentation

Find Arvo's documentation on urbit.org.

Development

To boot a fake ship from your development files, run urbit with the following arguments:

urbit -F zod -A /path/to/arvo -c fakezod

Mount Arvo's filesystem allows you to update its contents through Unix. To do so, run |mount in dojo. It is most common to |mount /=home=.

To create a custom pill (bootstrapping object) from the files loaded into the home desk, run .my/pill +solid. Your pill will appear in /path/to/fakezod/.urb/put/my.pill.

To boot a fake ship with a custom pill, use the -B flag:

urbit -F zod -A /path/to/arvo -B /path/to.pill -c fakezod

To run all tests in /tests, run -test %/tests in dojo. To run only the tests in /tests/some/path, use -test %/tests/some/path.

Maintainers

Most parts of Arvo have dedicated maintainers.

/sys/hoon: @pilfer-pandex (~pilfer-pandex)
/sys/zuse: @pilfer-pandex (~pilfer-pandex)
/sys/arvo: @joemfb (~master-morzod)
/sys/vane/ames: @belisarius222 (~rovnys-ricfer) & @philipcmonk (~wicdev-wisryt)
/sys/vane/behn: @belisarius222 (~rovnys-ricfer)
/sys/vane/clay: @philipcmonk (~wicdev-wisryt) & @belisarius222 (~rovnys-ricfer)
/sys/vane/dill: @fang- (~palfun-foslup)
/sys/vane/eyre: @fang- (~palfun-foslup)
/sys/vane/gall: @philipcmonk (~wicdev-wisryt)
/sys/vane/jael: @fang- (~palfun-foslup) & @philipcmonk (~wicdev-wisryt)
/app/acme: @joemfb (~master-morzod)
/app/dns: @joemfb (~master-morzod)
/app/aqua: @philipcmonk (~wicdev-wisryt)
/app/hood: @belisarius222 (~rovnys-ricfer)
/lib/hood/drum: @fang- (~palfun-foslup)
/lib/hood/kiln: @philipcmonk (~wicdev-wisryt)

Contributing

Contributions of any form are more than welcome! Please take a look at our contributing guidelines for details on our git practices, coding styles, how we manage issues, and so on.