mirror of https://github.com/urbit/shrub.git synced 2024-12-22 02:11:38 +03:00

History

Liam Fitzgerald 66c8cafe75 pull-hook: move +resource-for-update back into door, add %no-validate flag Adds %no-validate flag, to prevent checking the wire/src.bowl/resource all match-up to enable P2P connections. Moves the resource-for-update back into the inner door, to match the push-hook.		2021-02-02 14:27:12 +10:00
..
app	contact-push-hook: add blank personal psuedo-resource for personal contact subscriptions	2021-02-01 18:24:56 -06:00
gen	tally: also list the groups we're in	2021-01-11 22:56:02 +01:00
lib	pull-hook: move +resource-for-update back into door, add %no-validate flag	2021-02-02 14:27:12 +10:00
mar	push-hook: revert removal of +resource-for-update, change type from (unit resource) to (list resource) to support contact-push-hook use case	2021-02-01 14:49:14 -06:00
sur	Merge remote-tracking branch 'origin/la/contact-store' into lf/join-cleanup	2021-02-01 17:01:02 +10:00
sys	ames: cache message +jam in +on-memo	2021-01-20 15:29:45 -05:00
ted	group-threads: contact push/pull hooks added to group lifecycle	2021-02-01 16:19:25 -06:00
tests	zuse: moves lib/base64	2020-12-08 02:36:11 -08: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
LICENSE.txt	Pull in latest v0.8.0.rc changes	2019-07-16 15:59:39 -07:00
README.md	readme: improve clarity of phrasing around testing	2020-09-28 18:49:37 +02: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 %/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: @joemfb (~master-morzod)
/sys/vane/eyre: @eglaysher (~littel-ponnys)
/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: @philipcmonk (~wicdev-wisryt)
/lib/hood/kiln: @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.