$ rad issue open --title "flux capacitor underpowered" --description "Flux capacitor power requirements exceed current supply" --no-announce

╭─────────────────────────────────────────────────────────╮

│ Title   flux capacitor underpowered                     │

│ Author  z6MknSL…StBU8Vi (you)                           │

│ Status  open                                            │

│                                                         │

╭───────────────────────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title                         Author                    Labels   Assignees   Opened │

├───────────────────────────────────────────────────────────────────────────────────────────────────┤

╰───────────────────────────────────────────────────────────────────────────────────────────────────╯

```

╭─────────────────────────────────────────────────────────────────────────────────────────╮

│ ●  ID       Title                      Author                  Head     +   -   Updated │

├─────────────────────────────────────────────────────────────────────────────────────────┤

╰─────────────────────────────────────────────────────────────────────────────────────────╯

```

```

$ rad cob list --repo rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --type xyz.radicle.issue

$ rad cob list --repo rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --type xyz.radicle.patch

```

We can look at the issue COB.

```

resource 0656c217f917c3e06234771e9ecae53aba5e173e

author   z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

date     Thu, 15 Dec 2022 17:28:04 +0000

    }

    {

      "title": "flux capacitor underpowered",

      "type": "edit"

    }

```

We can look at the patch COB too.

```

resource 0656c217f917c3e06234771e9ecae53aba5e173e

rel      3e674d1a1df90807e934f9ae5da2591dd6848a33

rel      f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354

      "type": "edit"

    }

```

Finally let's updated the issue and see the `parent` header:

```

resource 0656c217f917c3e06234771e9ecae53aba5e173e

author   z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

date     Thu, 15 Dec 2022 17:28:04 +0000

      "type": "label"

    }

resource 0656c217f917c3e06234771e9ecae53aba5e173e

author   z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

date     Thu, 15 Dec 2022 17:28:04 +0000

    }

    {

      "title": "flux capacitor underpowered",

      "type": "edit"

    }

```

╭──────────────────────────────────────────────────────────────────────╮

│ heartwood                                                            │

├──────────────────────────────────────────────────────────────────────┤

│ 002   ●   bob/copy   Change copyright   branch   created   bob   now │

╰──────────────────────────────────────────────────────────────────────╯

```

╭────────────────────────────────────────────────────────────────╮

│ radicle-git                                                    │

├────────────────────────────────────────────────────────────────┤

╰────────────────────────────────────────────────────────────────╯

╭──────────────────────────────────────────────────────────────────────╮

│ heartwood                                                            │

├──────────────────────────────────────────────────────────────────────┤

│ 002   ●   bob/copy   Change copyright   branch   created   bob   now │

╰──────────────────────────────────────────────────────────────────────╯

```

╭──────────────────────────────────────────────────────────────────────╮

│ heartwood                                                            │

├──────────────────────────────────────────────────────────────────────┤

│ 002       bob/copy   Change copyright   branch   created   bob   now │

╰──────────────────────────────────────────────────────────────────────╯

```

╭────────────────────────────────────────────────────────────────╮

│ radicle-git                                                    │

├────────────────────────────────────────────────────────────────┤

╰────────────────────────────────────────────────────────────────╯

```

$ rad issue open --title "flux capacitor underpowered" --description "Flux capacitor power requirements exceed current supply" --no-announce

╭─────────────────────────────────────────────────────────╮

│ Title   flux capacitor underpowered                     │

│ Author  z6MknSL…StBU8Vi (you)                           │

│ Status  open                                            │

│                                                         │

╭───────────────────────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title                         Author                    Labels   Assignees   Opened │

├───────────────────────────────────────────────────────────────────────────────────────────────────┤

╰───────────────────────────────────────────────────────────────────────────────────────────────────╯

```

Show the issue information issue.

```

╭─────────────────────────────────────────────────────────╮

│ Title   flux capacitor underpowered                     │

│ Author  z6MknSL…StBU8Vi (you)                           │

│ Status  open                                            │

│                                                         │

duplicated. While we're at it, let's add a label.

```

```

It will now show in the list of issues assigned to us, along with the new label.

╭───────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title                         Author                    Labels             Assignees         Opened │

├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤

╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

```

Note: this can always be undone with the `unassign` subcommand.

```

```

Great, now we have communicated to the world about our car's defect.

It will help whoever works on a fix.

```

```

We can see our comments by showing the issue:

```

╭─────────────────────────────────────────────────────────╮

│ Title   flux capacitor underpowered                     │

│ Author  z6MknSL…StBU8Vi (you)                           │

│ Labels  good-first-issue                                │

│ Status  open                                            │

│                                                         │

│ Flux capacitor power requirements exceed current supply │

├─────────────────────────────────────────────────────────┤

│ The flux capacitor needs 1.21 Gigawatts                 │

├─────────────────────────────────────────────────────────┤

│ More power!                                             │

╰─────────────────────────────────────────────────────────╯

```

$ git checkout -b feature/1 -q

$ git commit --allow-empty -q -m "First change"

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

``` (stderr) RAD_SOCKET=/dev/null

$ git checkout feature/1 -q

$ git push -f

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

$ git checkout -b feature/1 -q

$ git commit --allow-empty -q -m "First change"

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

Finally, we push master and expect the patch to be merged.

``` (stderr) RAD_SOCKET=/dev/null

$ git push rad master

✓ Canonical head updated to 737a10cfa29111afeb0d43cf3545cee386b939ec

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

   f2de534..737a10c  master -> master

$ git checkout -b feature/1 -q

$ git commit --allow-empty -q -m "First change"

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

$ git checkout -b feature/2 -q master

$ git commit --allow-empty -q -m "Second change"

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

```

$ git branch -r

  rad/master

```

And some remote refs:

    │   ├── xyz.radicle.id

    │   │   └── 0656c217f917c3e06234771e9ecae53aba5e173e

    │   └── xyz.radicle.patch

    ├── heads

    │   ├── master

    │   └── patches

    └── rad

        ├── id

        └── sigrefs

``` (stderr) RAD_SOCKET=/dev/null

$ git push rad master

✓ Canonical head updated to d6399c71702b40bae00825b3c444478d06b4e91c

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

   f2de534..d6399c7  master -> master

│ ✔  [ ... ]  Second change  alice   (you)  daf349f  +0  -0  now     │

│ ✔  [ ... ]  First change   alice   (you)  20aa5dd  +0  -0  now     │

╰────────────────────────────────────────────────────────────────────╯

╭────────────────────────────────────────────────────────────────╮

│ Title     Second change                                        │

│ Author    alice (you)                                          │

│ Head      daf349ff76bedf48c5f292290b682ee7be0683cf             │

│ Branches  feature/2                                            │

│ daf349f Second change                                          │

├────────────────────────────────────────────────────────────────┤

│ ● opened by alice (you) (daf349f) now                          │

╰────────────────────────────────────────────────────────────────╯

```

    │   ├── xyz.radicle.id

    │   │   └── 0656c217f917c3e06234771e9ecae53aba5e173e

    │   └── xyz.radicle.patch

    ├── heads

    │   └── master

    └── rad

Then we create a patch from `feature/1`:

``` (stderr)

$ git push rad feature/1:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   feature/1 -> refs/patches

```

╭────────────────────────────────────────────────────────────────────────╮

│ ●  ID       Title     Author                  Head     +   -   Updated │

├────────────────────────────────────────────────────────────────────────┤

╰────────────────────────────────────────────────────────────────────────╯

```

When showing the patch, we see that it is `ahead 1, behind 1`, since master has

diverged by one commit:

```

╭────────────────────────────────────────────────────╮

│ Title     Add Alan                                 │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      5c88a79d75f5c2b4cc51ee6f163d2db91ee198d7 │

│ Base      f64fb2c8fe28f7c458c72ec8d700373924794943 │

$ sed -i '$a Mel Farna' CONTRIBUTORS

$ git commit -a -q -m "Add Mel"

$ git push -o patch.message="Add Mel" rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

When we look at the patch, we see that it has both commits, because this new

patch uses the same base as the previous patch:

```

╭────────────────────────────────────────────────────╮

│ Title     Add Mel                                  │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      7f63fcbcf23fc39eea784c091ad3d20d7e4bd005 │

│ Base      f64fb2c8fe28f7c458c72ec8d700373924794943 │

``` (stderr)

$ git push -o patch.message="Add Mel #2" -o patch.base=HEAD^ rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

that it is still two commits ahead and one behind from `master`.

```

╭────────────────────────────────────────────────────╮

│ Title     Add Mel #2                               │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      7f63fcbcf23fc39eea784c091ad3d20d7e4bd005 │

│ Base      5c88a79d75f5c2b4cc51ee6f163d2db91ee198d7 │

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new branch]      flux-capacitor-power -> flux-capacitor-power

$ git push rad -o patch.message="Define power requirements" -o patch.message="See details." HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

```

``` (stderr)

$ git push rad -o patch.message="Add README, just for the fun" HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

Our second patch looks like the following:

```

╭────────────────────────────────────────────────────╮

│ Title     Add README, just for the fun             │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      27857ec9eb04c69cacab516e8bf4b5fd36090f66 │

│ Base      f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 │

with a new `base`:

```

```

Now, if we show the patch we can see the patch's base has changed and

we have a single commit:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add README, just for the fun                              │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      27857ec9eb04c69cacab516e8bf4b5fd36090f66                  │

│ Base      3e674d1a1df90807e934f9ae5da2591dd6848a33                  │

│ 27857ec Add README, just for the fun                                │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (27857ec) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

``` ~alice (stderr)

$ git push rad -o patch.message="Define power requirements" -o patch.message="See details." HEAD:refs/patches

✓ Synced with 1 node(s)

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

$ rad sync -f

✓ Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from z6MknSL…StBU8Vi..

✓ Fetched repository from 1 seed(s)

✓ Switched to branch alice-init

```

Meanwhile, we may see some more changes that we need to make, so we

``` ~alice (stderr)

$ git push rad -o patch.message="Add README, just for the fun"

✓ Synced with 1 node(s)

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

Bob fetches these new changes and can see their branch is now behind:

``` ~bob (stderr)

$ git fetch rad

From rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji

```

``` ~bob

$ git status

On branch alice-init

  (use "git pull" to update your local branch)

nothing to commit, working tree clean

ensure that they are looking at the latest changes:

``` ~bob (fail)

✗ Performing checkout... <canceled>

✗ Error: branch 'alice-init' already exists (use `--force` to overwrite)

```

``` ~bob

✓ Switched to branch alice-init

$ git status

On branch alice-init

nothing to commit, working tree clean

```

$ touch LICENSE

$ git add LICENSE

$ git commit --message "Add LICENSE, just for the business"

 1 file changed, 0 insertions(+), 0 deletions(-)

 create mode 100644 LICENSE

$ git push rad -o patch.message="Add LICENSE, just for the business"

We can see the list of revisions of the patch by `show`ing it:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Define power requirements                                 │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      639f44a25145a37f747f3c84265037a9461e44c5                  │

│ Commits   ahead 3, behind 0                                         │

│ Status    open                                                      │

│                                                                     │

│ 3e674d1 Define power requirements                                   │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (3e674d1) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

So, let's checkout the previous revision, `0c0942e2`:

```

```

And we can confirm that the current commit corresponds to `27857ec`:

``` (stderr)

$ git push rad -o patch.message="Define power requirements" -o patch.message="See details." HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

Now, let's checkout the patch that we just created:

```

```

Note that `rad patch checkout` can be used to switch to the patch branch

```

$ git checkout master -q

```

Now, let's add a README too!

$ touch README.md

$ git add README.md

$ git commit --message "Add README, just for the fun"

 1 file changed, 0 insertions(+), 0 deletions(-)

 create mode 100644 README.md

```

``` (stderr)

$ git push rad -o patch.message="Add README, just for the fun"

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

$ git push rad HEAD:refs/patches

```

```

╭───────────────────────────╮

│ README.md +1 ❲created❳    │

├───────────────────────────┤

$ git push -f

```

```

╭─────────────────────────────╮

│ RADICLE.md +1 ❲created❳     │

├─────────────────────────────┤

too.

```

╭───────────────────────────╮

│ README.md +1 ❲created❳    │

├───────────────────────────┤

``` (stderr)

$ git push -o patch.draft -o patch.message="Nothing yet" rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

We can confirm it's a draft by running `show`:

```

╭────────────────────────────────────────────────────╮

│ Title     Nothing yet                              │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7 │

│ Branches  cloudhead/draft                          │

Once the patch is ready for review, we can use the `ready` command:

```

```

```

╭────────────────────────────────────────────────────╮

│ Title     Nothing yet                              │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7 │

│ Branches  cloudhead/draft                          │

the `--undo` flag:

```

╭────────────────────────────────────────────────────╮

│ Title     Nothing yet                              │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      2a465832b5a76abe25be44a3a5d224bbd7741ba7 │

│ Branches  cloudhead/draft                          │

``` (stderr)

$ git push rad -o patch.message="Add README, just for the fun" HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

``` (stderr)

$ git push -f -o patch.message="Add License"

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

Let's look at the patch, to see what it looks like before editing it:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add README, just for the fun                              │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      8945f6189adf027892c85ac57f7e9341049c2537                  │

│ Branches  changes                                                   │

│ 03c02af Add README, just for the fun                                │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (03c02af) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

multi-line message (using two `--message` options here):

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add Metadata                                              │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      8945f6189adf027892c85ac57f7e9341049c2537                  │

│ Branches  changes                                                   │

│ 03c02af Add README, just for the fun                                │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (03c02af) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

`--revision` option:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add Metadata                                              │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      8945f6189adf027892c85ac57f7e9341049c2537                  │

│ Branches  changes                                                   │

│ 03c02af Add README, just for the fun                                │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (03c02af) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

$ git checkout master -q

$ git branch -D alice/1 -q

$ git update-ref -d refs/remotes/rad/alice/1

$ git gc --prune=now

$ git branch -r

  rad/master

Already up to date.

$ git branch -r

  rad/master

```

$ git checkout -b feature/1 -q

$ git commit --allow-empty -q -m "First change"

$ git push -o patch.draft rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

$ git checkout master -q

$ git merge feature/1

$ git push rad master

✓ Canonical head updated to 20aa5dde6210796c3a2f04079b42316a31d02689

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

   f2de534..20aa5dd  master -> master

$ git checkout -b changes -q

$ git commit --allow-empty -q -m "Changes"

$ git push rad HEAD:refs/patches

✓ Synced with 1 node(s)

To rad://z3yXbb1sR6UG6ixxV2YF9jUP7ABra/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

 * [new reference]   HEAD -> refs/patches

``` (stderr)

$ git commit --amend --allow-empty -q -m "Other changes"

$ git push -f

✓ Synced with 1 node(s)

To rad://z3yXbb1sR6UG6ixxV2YF9jUP7ABra/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

```

While simply pushing a commit outputs a URL to the new source tree.

$ git checkout master -q

$ git merge changes -q

$ git push rad master

✓ Canonical head updated to b2b6432af93f8fe188e32d400263021b602cfec8

✓ Synced with 1 node(s)

$ git checkout -b bob/feature -q

$ git commit --allow-empty -m "Bob's commit #1" -q

$ git push rad -o sync -o patch.message="Bob's patch" HEAD:refs/patches

✓ Synced with 1 node(s)

To rad://zhbMU4DUXrzB8xT6qAJh6yZ7bFMK/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

 * [new reference]   HEAD -> refs/patches

```

``` ~bob

$ git status --short --branch

```

Alice checks it out.

``` ~alice

$ git show

commit bdcdb30b3c0f513620dd0f1c24ff8f4f71de956b

Author: radicle <radicle@localhost>

``` ~bob (stderr)

$ git commit --allow-empty -m "Bob's commit #2" -q

$ git push rad -o sync -o patch.message="Updated."

✓ Synced with 1 node(s)

To rad://zhbMU4DUXrzB8xT6qAJh6yZ7bFMK/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

```

Alice pulls the update.

``` ~alice

╭─────────────────────────────────────────────────────────────────────╮

│ Title    Bob's patch                                                │

│ Author   bob z6Mkt67…v4N1tRk                                        │

│ Head     cad2666a8a2250e4dee175ed5044be2c251ff08b                   │

│ Commits  ahead 2, behind 0                                          │

│ bdcdb30 Bob's commit #1                                             │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by bob z6Mkt67…v4N1tRk (bdcdb30) now                       │

╰─────────────────────────────────────────────────────────────────────╯

$ git ls-remote rad

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354	refs/heads/master

```

``` ~alice

$ git fetch rad

$ git status --short --branch

```

``` ~alice

$ git pull

```

``` (stderr)

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

```

╭────────────────────────────────────────────────────╮

│ Title     Not a real change                        │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      51b2f0f77b9849bfaa3e9d3ff68ee2f57771d20c │

│ Branches  feature/1                                │

we run:

```

```

The command outputs the new Revision ID, which we can now see here:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Not a real change                                         │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      4d272148458a17620541555b1f0905c01658aa9f                  │

│ Branches  feature/1                                                 │

│ 51b2f0f Not a real change                                           │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (51b2f0f) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

Switched to a new branch 'feature/1'

$ git commit -a -m "Add things" -q --allow-empty

$ git push -o patch.message="Add things #1" -o patch.message="See commits for details." rad HEAD:refs/patches

hint: offline push, your node is not running

hint: to sync with the network, run `rad node start`

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

We can see a patch was created:

```

╭────────────────────────────────────────────────────╮

│ Title     Add things #1                            │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      42d894a83c9c356552a57af09ccdbd5587a99045 │

│ Branches  feature/1                                │

```

$ git branch -vv

  master    f2de534 [rad/master] Second commit

```

```

$ git status --short --branch

$ git fetch

$ git push

```

42d894a83c9c356552a57af09ccdbd5587a99045 refs/heads/feature/1

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 refs/heads/master

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 refs/remotes/rad/master

```

```

$ git ls-remote rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji 'refs/heads/patches/*'

$ git ls-remote rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi 'refs/cobs/*'

0656c217f917c3e06234771e9ecae53aba5e173e	refs/cobs/xyz.radicle.id/0656c217f917c3e06234771e9ecae53aba5e173e

```

We can create another patch:

$ git checkout -b feature/2 -q master

$ git commit -a -m "Add more things" -q --allow-empty

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

```

$ git branch -vv

  master    f2de534 [rad/master] Second commit

```

╭───────────────────────────────────────────────────────────────────────────────╮

│ ●  ID       Title            Author                  Head     +   -   Updated │

├───────────────────────────────────────────────────────────────────────────────┤

╰───────────────────────────────────────────────────────────────────────────────╯

```

``` (stderr)

$ git push rad

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

This last `git push` worked without specifying an upstream branch despite the

We can then see that the patch head has moved:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add more things                                           │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      02bef3fac41b2f98bb3c02b868a53ddfecb55b5f                  │

│ Branches  feature/2                                                 │

│ 8b0ea80 Add more things                                             │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (8b0ea80) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

```

$ git status --short --branch

```

```

02bef3fac41b2f98bb3c02b868a53ddfecb55b5f

```

## Force push

``` (stderr) (fail)

$ git push

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

error: failed to push some refs to 'rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi'

hint: [..]

hint: [..]

``` (stderr)

$ git push --force

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

That worked. We can see the new revision if we call `rad patch show`:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Add more things                                           │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Head      9304dbc445925187994a7a93222a3f8bde73b785                  │

│ Branches  feature/2                                                 │

│ 8b0ea80 Add more things                                             │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (8b0ea80) now                     │

╰─────────────────────────────────────────────────────────────────────╯

```

``` (stderr)

$ git push rad -o patch.message="Define power requirements" -o patch.message="See details." HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

╭─────────────────────────────────────────────────────────────────────────────────────────╮

│ ●  ID       Title                      Author                  Head     +   -   Updated │

├─────────────────────────────────────────────────────────────────────────────────────────┤

╰─────────────────────────────────────────────────────────────────────────────────────────╯

```

```

╭────────────────────────────────────────────────────╮

│ Title     Define power requirements                │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Head      3e674d1a1df90807e934f9ae5da2591dd6848a33 │

│ Branches  flux-capacitor-power                     │

╭─────────────────────────────────────────────────────────────────────────────────────────╮

│ ●  ID       Title                      Author                  Head     +   -   Updated │

├─────────────────────────────────────────────────────────────────────────────────────────┤

╰─────────────────────────────────────────────────────────────────────────────────────────╯

```

We can also see that it set an upstream for our patch branch:

```

$ git branch -vv

  master               f2de534 [rad/master] Second commit

```

organise your workflow:

```

╭────────────────────────────────────────────────────╮

│ Title     Define power requirements                │

│ Author    z6MknSL…StBU8Vi (you)                    │

│ Labels    fun                                      │

│ Head      3e674d1a1df90807e934f9ae5da2591dd6848a33 │

```

``` (stderr)

$ git push rad -o patch.message="Add README, just for the fun"

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

And let's leave a quick comment for our team:

```

╭───────────────────────────────────────╮

│ I cannot wait to get back to the 90s! │

╰───────────────────────────────────────╯

```

Now, let's checkout the patch that we just created:

```

```

We can also add a review verdict as such:

```

```

Showing the patch list now will reveal the favorable verdict:

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Define power requirements                                 │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Labels    fun                                                       │

│ Head      27857ec9eb04c69cacab516e8bf4b5fd36090f66                  │

│ Commits   ahead 2, behind 0                                         │

│ Status    open                                                      │

│                                                                     │

│ 3e674d1 Define power requirements                                   │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (3e674d1) now                     │

│   └─ ✓ accepted by z6MknSL…StBU8Vi (you) now                        │

╰─────────────────────────────────────────────────────────────────────╯

```

If you make a mistake on the patch description, you can always change it!

```

╭─────────────────────────────────────────────────────────────────────╮

│ Title     Define power requirements                                 │

│ Author    z6MknSL…StBU8Vi (you)                                     │

│ Labels    fun                                                       │

│ Head      27857ec9eb04c69cacab516e8bf4b5fd36090f66                  │

│ Commits   ahead 2, behind 0                                         │

│ Status    open                                                      │

│                                                                     │

│ 3e674d1 Define power requirements                                   │

├─────────────────────────────────────────────────────────────────────┤

│ ● opened by z6MknSL…StBU8Vi (you) (3e674d1) now                     │

│   └─ ✓ accepted by z6MknSL…StBU8Vi (you) now                        │

╰─────────────────────────────────────────────────────────────────────╯

```

$ git rev-parse HEAD

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354

$ git checkout master -q

$ rad remote add z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

✓ Follow policy updated for z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

✓ Fetching rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from z6Mkt67…v4N1tRk..

$ git checkout master -q

$ cat .git/FETCH_HEAD

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354	not-for-merge	branch 'master' of rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk

$ git rev-parse master

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354

```

``` ~alice (stderr)

$ git commit --allow-empty -m "Changes #2" -q

$ git push

✓ Synced with 1 node(s)

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

``` ~bob

$ git checkout master -q

$ git pull

From rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji

$ git checkout - -q

$ git commit --allow-empty -m "Changes #3" -q

$ git push

✓ Synced with 1 node(s)

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

```

``` ~alice

$ cat .git/FETCH_HEAD

f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354		branch 'master' of rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji

```

``` ~bob (stderr)

$ git checkout master -q

$ git pull

From rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji

```

``` ~bob

``` (stderr)

$ git push rad HEAD:refs/patches

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi

 * [new reference]   HEAD -> refs/patches

```

match `git diff master -W100% -U5 --patience`:

```

diff --git a/.gitignore b/.gitignore

deleted file mode 100644

index 7937fb3..0000000

Now let's accept these hunks one by one..

```

diff --git a/.gitignore b/.gitignore

deleted file mode 100644

index 7937fb3..0000000

-*.draft

```

```

diff --git a/DISCLAIMER.txt b/DISCLAIMER.txt

new file mode 100644

index 0000000..2b5bd86

+All food is served as-is, with no warranty!

```

```

diff --git a/MENU.txt b/MENU.txt

index 867958c..3af9741 100644

--- a/MENU.txt

[..]

```

```

diff --git a/MENU.txt b/MENU.txt

index 4e2e828..3af9741 100644

--- a/MENU.txt

```

```

diff --git a/INSTRUCTIONS.txt b/notes/INSTRUCTIONS.txt

similarity index 100%

rename from INSTRUCTIONS.txt

```

```

✓ All hunks have been reviewed

```

╭─────────────────────────────────────────────────────────────────────────────────────╮

│ ●   Node                      Address                  Status   Tip       Timestamp │

├─────────────────────────────────────────────────────────────────────────────────────┤

╰─────────────────────────────────────────────────────────────────────────────────────╯

```

$ rad issue open --title "flux capacitor underpowered" --description "Flux capacitor power requirements exceed current supply" --no-announce

╭─────────────────────────────────────────────────────────╮

│ Title   flux capacitor underpowered                     │

│ Author  bob (you)                                       │

│ Status  open                                            │

│                                                         │

╭──────────────────────────────────────────────────────────────────────────────────────────╮

│ ●   ID        Title                         Author           Labels   Assignees   Opened │

├──────────────────────────────────────────────────────────────────────────────────────────┤

╰──────────────────────────────────────────────────────────────────────────────────────────╯

```