mirror of https://github.com/urbit/shrub.git synced 2024-12-01 14:42:02 +03:00

History

Benjamin Summers 5b931657c8 Merge branch 'master' of github.com:urbit/urbit into king-haskell		2019-12-19 08:14:49 -08:00
..
.travis	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
app	gaze: reflect changes to eth-watcher	2019-12-18 11:38:56 -03:30
gen	gen: add +azimuth-sources	2019-12-18 10:41:39 -03:30
lib	goad: recompile apps after changes to /sys	2019-12-13 17:14:51 -08:00
mar	link: make network comms work	2019-12-11 20:49:50 +01:00
ren	Can now \|hi to King Haskell over Ames! (and merged Master)	2019-07-31 22:16:02 -07:00
sur	jael: add "eager" mode to avoid hitting nodes as much	2019-12-18 10:58:00 -03:30
sys	Merge branch 'philip/eth-watcher' (#2113 )	2019-12-18 12:13:27 -03:30
ted	ph: fix tests by spamming blocks regularly	2019-12-18 11:53:36 -03:30
tests	ames: handle misordered crashing boons	2019-12-17 20:58:30 -08:00
.gitignore	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
.ignore	Write top-level pier code; hook up Ames and Behn.	2019-07-31 19:34:14 -07:00
.travis.yml	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
LICENSE.txt	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
README.md	master without pills, hopefully	2019-10-14 16:02:27 -04:00
TESTING.udon	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -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.