# SoCLI

> Cross-platform TUI social media client for X, Bluesky, dev/null, Threads and Mastodon.

SoCLI is a Rust terminal client. Agents should run it with --json or --print, never the full-screen reader. Docs: https://socli.sh/docs/

## Table of Contents

- [Agents](https://socli.sh/docs/agents.md): How SoCLI behaves when an AI coding agent or a script drives it.
- [Brand](https://socli.sh/design.md): The SoCLI mark is So_, a rounded square with the name and the cursor.
- [CLI commands](https://socli.sh/docs/commands.md): Run SoCLI from the shell with direct commands, positional arguments, options, stdin and JSON output.
- [Configuration](https://socli.sh/docs/config.md): Where SoCLI keeps its settings, every config key, and the environment variables that override them.
- [Data deletion](https://socli.sh/data-deletion.md): How to remove Threads and Facebook data from SoCLI, and the address Meta can call.
- [Images](https://socli.sh/docs/images.md): How SoCLI draws pictures in the terminal, and how to choose the graphics mode.
- [Install](https://socli.sh/docs/install.md): Run SoCLI with npx or bunx, install the native command, or build it from source.
- [Keys](https://socli.sh/docs/keys.md): Keyboard shortcuts for the SoCLI terminal reader, composer, command palette, dialogs and settings.
- [Networks](https://socli.sh/docs/networks.md): What SoCLI can read and write on X, Bluesky, dev/null, Threads and Mastodon, and what each network leaves out.
- [Privacy policy](https://socli.sh/privacy.md): What SoCLI stores when you sign in, and the one Threads request that reaches socli.sh.
- [Quick start](https://socli.sh/docs.md): What SoCLI is, and how to install it, open the demo, sign in and post.
- [Reader](https://socli.sh/docs/reader.md): What the full-screen reader shows, the keys it takes, the detail levels it draws and the themes it ships.
- [Sign in](https://socli.sh/docs/login.md): How to sign in to X, Bluesky, dev/null, Threads and Mastodon, and how to check the accounts SoCLI uses.
- [Terms](https://socli.sh/terms.md): What you get when you use SoCLI, and what socli.sh does not store.
- [Web implementation](https://socli.sh/docs/web.md): The SoCLI reader in the browser, compiled to WebAssembly, with sign-in, live timelines, and the same Rust rendering core as the native CLI.