mirror of https://github.com/urbit/shrub.git synced 2024-12-21 18:01:32 +03:00

History

Philip Monk 1eeca16f1a dns: give quieter errors !! crashes the thread, so dojo prints a stack trace. An explicit failure lets you give a custom error message.		2019-12-05 11:59:59 -08:00
..
.travis	Add 'pkg/arvo/' from commit 'c20e2a185f131ff3f5d3961829bd7a3fe0f227f8'	2019-06-28 12:48:05 +08:00
app	chat-store: fix errant 'this'	2019-12-05 21:18:11 +08:00
gen	aqua: make faster so moon-az can finish	2019-12-03 23:53:42 -08:00
lib	Merge branch 'philip/boot-order' (#2023 )	2019-12-05 16:45:25 +08:00
mar	Merge remote-tracking branch 'origin/master' into rc	2019-11-30 21:54:36 -08:00
ren	updated publish files	2019-07-18 15:34:42 -07:00
sur	Merge commit 'fbc81b59'; remote-tracking branch 'origin/mp-chat-redesign' into rc	2019-11-30 16:17:28 -08:00
sys	ames: don't crash on missing queued larval event	2019-12-05 17:04:24 +08:00
ted	dns: give quieter errors	2019-12-05 11:59:59 -08:00
tests	Merge remote-tracking branch 'origin/master' into rc	2019-11-30 21:54:36 -08:00
.gitignore	Add 'pkg/arvo/' from commit 'c20e2a185f131ff3f5d3961829bd7a3fe0f227f8'	2019-06-28 12:48:05 +08:00
.travis.yml	Add 'pkg/arvo/' from commit 'c20e2a185f131ff3f5d3961829bd7a3fe0f227f8'	2019-06-28 12:48:05 +08:00
LICENSE.txt	Add 'pkg/arvo/' from commit 'c20e2a185f131ff3f5d3961829bd7a3fe0f227f8'	2019-06-28 12:48:05 +08:00
README.md	master without pills, hopefully	2019-10-14 16:02:27 -04:00
TESTING.udon	Moved testing documentation out of tests folder so as to pass tests~	2019-07-05 16:48:40 -07:00

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 in dojo. +test /some/path would only run all tests in /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: @jtobin (~nidsut-tomdun)
/sys/vane/ames: @belisarius222 (~rovnys-ricfer) & @joemfb (~master-morzod)
/sys/vane/behn: @belisarius222 (~rovnys-ricfer)
/sys/vane/clay: @philipcmonk (~wicdev-wisryt)
/sys/vane/dill: @bernardodelaplaz (~rigdyn-sondur)
/sys/vane/eyre: @eglaysher (~littel-ponnys)
/sys/vane/ford: @belisarius222 (~rovnys-ricfer) & @eglaysher (~littel-ponnys)
/sys/vane/gall: @jtobin (~nidsut-tomdun)
/sys/vane/jael: @fang- (~palfun-foslup) & @joemfb (~master-morzod)
/app/acme: @joemfb (~master-morzod)
/app/dns: @joemfb (~master-morzod)
/app/hall: @fang- (~palfun-foslup)
/app/talk: @fang- (~palfun-foslup)
/app/aqua: @philipcmonk (~wicdev-wisryt)
/lib/test: @eglaysher (~littel-ponnys)

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.