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

History

fang ce3eb011ad hoon: drop faces during +ar Since this is the ?# codepath, we want to drop any faces that might already exist, since we'll bring our own (through %name in +gain:ar). Co-authored-by: joemfb <joemfb@users.noreply.github.com>		2022-07-01 18:33:15 +02:00
..
app	Merge pull request #5841 from dnmfarrell/dnmfarrell/arvo-dojo-dont-crash-set-beak	2022-06-18 14:25:04 +02:00
gen	clay: don't require head of foreign desks	2022-05-17 17:06:03 -07:00
lib	various: make all files build correctly	2022-05-14 22:49:10 -07:00
mar	Merge branch 'master' into next/arvo	2022-06-30 12:59:41 +02:00
sur	Merge pull request #5647 from urbit/roller/batch-split	2022-05-03 14:34:12 -07:00
sys	hoon: drop faces during +ar	2022-07-01 18:33:15 +02:00
ted	dns: transfer ship.arvo.network domains from ~zod to ~deg	2022-06-26 00:24:20 +03:00
tests	clay: update tests	2022-05-20 20:03:34 -07:00
.gitattributes	gitattributes: export-ignore additions [ci skip]	2020-02-01 17:40:27 +04:00
.ignore	Write top-level pier code; hook up Ames and Behn.	2019-07-31 19:34:14 -07:00
desk.bill	Merge branch 'master' into naive/roller	2021-10-26 20:46:32 +02:00
LICENSE.txt	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
README.md	%home -> %base	2022-03-06 11:55:55 -05:00
sys.kelvin	clay: bump kelvin, refactor	2022-04-06 00:18:23 -07: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 /=base=.

To create a custom pill (bootstrapping object) from the files loaded into the base 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.