anythink-cli

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/anythink-logo-dark.svg">
  <img alt="Anythink" src="assets/anythink-logo.svg" height="40">
</picture>

# Anythink CLI

The official command-line interface for [Anythink](https://anythink.cloud) — the headless backend platform for developers and founders. Manage your projects, entities, data, workflows, users, files, and payments without leaving the terminal.

[![NuGet](https://img.shields.io/nuget/v/anythink-mcp?logo=nuget&label=anythink-mcp)](https://www.nuget.org/packages/anythink-mcp)
[![Release](https://img.shields.io/github/v/release/anythink-cloud/anythink-cli?logo=github&label=release)](https://github.com/anythink-cloud/anythink-cli/releases/latest)
[![Homebrew](https://img.shields.io/badge/homebrew-anythink--cloud%2Ftap-F9A825?logo=homebrew&logoColor=white)](https://github.com/anythink-cloud/homebrew-tap)
[![MCP Registry](https://img.shields.io/badge/MCP_registry-cloud.anythink%2Fanythink-0098FF)](https://registry.modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

```
   ░███                             ░██    ░██        ░██           ░██
  ░██░██                            ░██    ░██                      ░██
 ░██  ░██  ░████████  ░██    ░██ ░████████ ░████████  ░██░████████  ░██    ░██
░█████████ ░██    ░██ ░██    ░██    ░██    ░██    ░██ ░██░██    ░██ ░██   ░██
░██    ░██ ░██    ░██ ░██    ░██    ░██    ░██    ░██ ░██░██    ░██ ░███████
░██    ░██ ░██    ░██ ░██   ░███    ░██    ░██    ░██ ░██░██    ░██ ░██   ░██
░██    ░██ ░██    ░██  ░█████░██     ░████ ░██    ░██ ░██░██    ░██ ░██    ░██
                             ░██
                       ░███████
```

---

## Contents

- [Installation](#installation)
- [Getting started](#getting-started)
- [Command reference](#command-reference)
  - [signup / login / logout](#signup--login--logout)
  - [accounts](#accounts)
  - [projects](#projects)
  - [config](#config)
  - [entities](#entities)
  - [fields](#fields)
  - [data](#data)
  - [search](#search)
  - [workflows](#workflows)
  - [users](#users)
  - [files](#files)
  - [roles](#roles)
  - [api-keys](#api-keys)
  - [menus](#menus)
  - [integrations](#integrations)
  - [pay](#pay)
  - [oauth](#oauth)
  - [api](#api)
  - [docs](#docs)
  - [migrate](#migrate)
  - [plans](#plans)
- [MCP server](#mcp-server)
- [Contributing](#contributing)
- [License](#license)

---

## Installation

Both the `anythink` CLI and the `anythink-mcp` server are distributed together. The quickest way to get both is Homebrew.

### Homebrew (macOS / Linux) — recommended

```bash
brew install anythink-cloud/tap/anythink
```

This installs **both** commands onto your `PATH`:

- `anythink` — the CLI
- `anythink-mcp` — the MCP server (see [MCP server](#mcp-server))

Upgrade later with `brew upgrade anythink`.

### macOS / Linux — download binary

Grab the latest release for your platform from the [Releases](https://github.com/anythink-cloud/anythink-cli/releases/latest) page:

| Platform              | Binary                 |
| --------------------- | ---------------------- |
| macOS (Apple Silicon) | `anythink-osx-arm64`   |
| macOS (Intel)         | `anythink-osx-x64`     |
| Linux (x86_64)        | `anythink-linux-x64`   |
| Linux (ARM64)         | `anythink-linux-arm64` |

```bash
# Example — macOS Apple Silicon
curl -Lo anythink https://github.com/anythink-cloud/anythink-cli/releases/latest/download/anythink-osx-arm64
chmod +x anythink
sudo mv anythink /usr/local/bin/
```

The MCP server ships as a matching `anythink-mcp-<platform>` binary on the same release — download and install it the same way (e.g. `anythink-mcp-osx-arm64`).

Verify the download against `checksums.txt` in the release assets:

```bash
sha256sum -c checksums.txt --ignore-missing
```

### .NET global tool

If you have the [.NET 8 SDK](https://dotnet.microsoft.com/download) installed:

```bash
dotnet tool install --global anythink-cli
```

### Build from source

```bash
git clone https://github.com/anythink-cloud/anythink-cli
cd anythink-cli
dotnet build
dotnet run -- --help
```

---

## Getting started

```bash
# 1. Create an account (or log in if you already have one)
anythink signup

# 2. Create a billing account
anythink accounts create --name "My Company"

# 3. Create a project
anythink projects create "My App" --region lon1

# 4. Connect to the project
anythink projects use <project-id>

# 5. Start building
anythink entities list
anythink workflows list
```

Your credentials and project profiles are stored in `~/.anythink/config.json`. You can manage multiple projects by running `projects use` to switch between them.

---

## Command reference

### signup / login / logout

```
anythink signup                        Create a new Anythink account
anythink login                         Log in to the platform
anythink logout                        Remove saved credentials for a project profile
```

`signup` and `login` are interactive — they prompt for email and password and walk you through connecting to a billing account and project on first run.

---

### accounts

Manage billing accounts. A billing account is the container for one or more projects and holds your subscription and payment details.

```
anythink accounts list                 List your billing accounts
anythink accounts create               Create a new billing account
anythink accounts use <id>             Set the active billing account
```

**Examples**

```bash
anythink accounts create --name "Acme Ltd" --email billing@acme.com
anythink accounts use a1b2c3d4
```

---

### projects

Create and manage Anythink projects. Each project is an isolated backend instance with its own database, auth, files, and workflows.

```
anythink projects list                 List projects in the active billing account
anythink projects create <name>        Create a new project
anythink projects use <id>             Connect to a project (sets it as the active profile)
anythink projects delete <id>          Delete a project
```

**Options — `projects create`**

| Flag            | Description                     |
| --------------- | ------------------------------- |
| `--region <id>` | Deployment region (e.g. `lon1`) |
| `--plan <id>`   | Plan ID (see `anythink plans`)  |

**Examples**

```bash
anythink projects create "My App" --region lon1
anythink projects use a1b2c3d4
anythink projects delete a1b2c3d4 --yes
```

---

### config

View and manage saved CLI profiles.

```
anythink config show                   List all profiles and platform settings
anythink config use <profile>          Set the active project profile
anythink config remove <profile>       Remove a profile
```

Profiles are named by project alias or ID and stored in `~/.anythink/config.json`.

---

### entities

Manage entities (database tables) in the active project.

```
anythink entities list                 List all entities
anythink entities get <name>           Get entity details and fields
anythink entities create <name>        Create a new entity
anythink entities update <name>        Update entity settings
anythink entities delete <name>        Delete an entity and all its data
```

**Options — `entities create`**

| Flag         | Description                                |
| ------------ | ------------------------------------------ |
| `--rls`      | Enable row-level security                  |
| `--public`   | Make the entity publicly readable          |
| `--lock`     | Lock new records (prevent direct creation) |
| `--junction` | Mark as a junction (many-to-many) table    |

**Examples**

```bash
anythink entities create orders --rls
anythink entities get customers
anythink entities delete temp_data --yes
```

---

### fields

Manage fields on an entity. Fields map directly to database columns.

```
anythink fields list <entity>          List fields on an entity
anythink fields add <entity> <name>    Add a field
anythink fields delete <entity> <id>   Delete a field
```

**Options — `fields add`**

| Flag                | Description                                                                       |
| ------------------- | --------------------------------------------------------------------------------- |
| `--type <type>`     | Field type: `varchar`, `text`, `int`, `float`, `bool`, `datetime`, `json`, `uuid` |
| `--required`        | Mark the field as required                                                        |
| `--unique`          | Enforce a unique constraint                                                       |
| `--indexed`         | Add a database index                                                              |
| `--default <value>` | Default value                                                                     |

**Examples**

```bash
anythink fields list customers
anythink fields add customers email --type varchar --unique --required
anythink fields add products price --type float --required
anythink fields delete customers 1234 --yes
```

---

### data

CRUD operations on entity records.

```
anythink data list <entity>            List records
anythink data get <entity> <id>        Get a single record by ID
anythink data create <entity>          Create a new record
anythink data update <entity> <id>     Update a record
anythink data delete <entity> <id>     Delete a record
```

**Options — `data list`**

| Flag              | Description                                                                        |
| ----------------- | ---------------------------------------------------------------------------------- |
| `--limit <n>`     | Records per page (default: 20)                                                     |
| `--page <n>`      | Page number (default: 1)                                                           |
| `--filter <expr>` | Field filters — JSON (`{"status":"draft","total":{"gte":10}}`) or `field=value` pairs (`status=draft&total=GTE:10`). See below. |
| `-