noosphere-cli 0.13.1

Reference client and pedagogical tool to demonstrate the principles of the Noosphere protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

![API Stability: Alpha](https://img.shields.io/badge/API%20Stability-Alpha-red)

# Noosphere CLI

The Noosphere CLI is a reference client and pedagogical tool to demonstrate
the principles of the Noosphere protocol and give interested users a
no-code, low-complexity tool to synchronize content through the Noosphere.


## Usage
### User perspective
```sh
# Create an identity
orb key create `whoami`

# make a directory for your sphere.
mkdir my-sphere
cd my-sphere

# Generate your personal sphere.
orb sphere create --owner-key `whoami`

# ..now make edits ..

# see the status of files in your directory
orb status

# persist changes to the sphere
orb save

# link your sphere to a gateway by setting this identity as the counterpart
orb config set gateway-url <gatewayurl>

# sync your changes with the upstream gateway
orb sync

# sync data from a different sphere. Note, you'll need to
# `orb auth add <did>` from that other sphere.
orb sphere join <their DID> --local-key `whoami`
orb sync # pull in their changes

# then follow the onscreen instructions.
```

### Gateway perspective
Note: The name `mygateway` below isn't special. Just a chosen name.

```sh
# Create an identity
orb key create mygateway

# make a directory for your sphere.
mkdir my-sphere
cd my-sphere

# Generate your personal sphere.
orb sphere create --owner-key mygateway

# Pair this with a user identity
orb config set counterpart <DID from the user>
```