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 f3e9204
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 2 deletions.
7 changes: 5 additions & 2 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 Down
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 f3e9204

Please sign in to comment.