Skip to content

Commit

Permalink
Add README
Browse files Browse the repository at this point in the history
  • Loading branch information
Toby Padilla committed Jul 30, 2021
1 parent d5a1b3c commit e04b2ff
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Smoothie

Distribute your software on the command line with SSH and Git.

## What is it

Smoothie is a SSH server that hosts a Git server and interactive TUI built from
the repos you push to it. Authors can easily push their projects to Smoothie by
adding it as a remote and users can clone repos from Smoothie and stay up to
date with the TUI as you push commits.

## Pushing a repo

1. Run `smoothie`
2. Add smoothie as a remote on any git repo: `git remote add smoothie ssh://git@localhost:23231/smoothie`
3. Push stuff: `git push smoothie main`

## Cloning a repo

1. You'll need to know the name (for now, it's not listed anywhere): `git clone ssh://git@localhost:23231/smoothie`

## Smoothie TUI

If you `ssh localhost -p 23231` you'll see a list of the latest commits to the repos you've pushed.

## Auth

By default anyone can push or pull from the Git repositories. This is mainly
for testing, you can also whitelist public keys that have Git write access by
creating an authorized keys file with the public key for each author. By
default this file is expected to be at `./.ssh/smoothie_git_authorized_keys`.

0 comments on commit e04b2ff

Please sign in to comment.