Skip to content

Commit

Permalink
add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
treethought committed Jun 9, 2024
1 parent 071c878 commit f4cf653
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 3 deletions.
9 changes: 6 additions & 3 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,9 +1,12 @@
name: release

# on:
# push:
# tags:
# - "*"
on:
pull_request:
push:
tags:
- "*"

permissions:
contents: write
Expand All @@ -28,6 +31,6 @@ jobs:
distribution: goreleaser
# 'latest', 'nightly', or a semver
version: '~> v2'
args: release --clean
args: release --clean --snapshot
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
26 changes: 26 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# tofui

tofui (Terminally On Farcaster User Interface) is a TUI for [farcaster](https://www.farcaster.xyz/).

It supports running locally using your own [Neynar](https://neynar.com/) application, or as a hosteds SSH app using [wish](https://github.com/charmbracelet/wish)

## Usage

To use the hosted version, simply ssh into the app using port 42069. Each ssh session interacts receives it's own application, and uses your SSH public key to drive the sign in flow using neynar's [SIWN](https://docs.neynar.com/docs/how-to-let-users-connect-farcaster-accounts-with-write-access-for-free-using-sign-in-with-neynar-siwn).
```
ssh -p 42069 tofui.xyz
```

### Running locally

Running the app locally can be done by downloading the binary from the [releases](https://github.com/treethought/tofui/releases) page or cloning the repo and running `make build`.

Running locally requires your own Neynar application. After creating one, copy [config.yaml.example](./config.yaml.example) to config.yaml and updating with your app's values.

To run as a normal local TUI, simply run `./tofui`.

To serve the app via an SSH server, simply run `tofui ssh`




0 comments on commit f4cf653

Please sign in to comment.