# kindgi connections > Connections: accounts at other apps that tools act with (list / get / connect / disconnect) ## `kindgi connections` **Synopsis** ```sh signature kindgi connections ``` Connections: accounts at other apps that tools act with (list / get / connect / disconnect). **Commands** | Command | Description | | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`kindgi connections list`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections-list) | List connections: a member's own, every one for a tenant admin. | | [`kindgi connections get`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections-get) | One connection: whose account it is, its permissions and its state. | | [`kindgi connections connect`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections-connect) | Connect your account at an app (the company's with --for-company): prints the link to open, and at a terminal waits until the connect finishes and says whose account it is. | | [`kindgi connections disconnect`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections-disconnect) | Disconnect: withdraws the access at the app where it can, destroys the token, and prints what was done. | **See also** - [Connect your apps](https://docs.kindgi.com/v0.3.1/guides/connections.md) - [How connections work](https://docs.kindgi.com/v0.3.1/guides/connections/reference.md) ### `kindgi connections list` **Synopsis** ```sh signature kindgi connections list [--project=] [--app=] [--mine] [--include-removed] [--limit=] [--cursor=] [--table] ``` List connections: a member's own, every one for a tenant admin. `--mine` keeps to your own. Removed ones are left out unless `--include-removed`. **Options** | Option | Default | Description | | ------------------- | -------------------- | ------------------------------------------------------------------------------ | | `--app ` | none | Only this app's, by its entry id: `google`, `microsoft`, `github`, `linkedin`. | | `--cursor ` | none | The next page, from `nextCursor`. | | `--include-removed` | off | Removed connections too, with when (`removedAt`). | | `--limit ` | `25` (at most `100`) | Page size. | | `--mine` | off | Only your own, even as a tenant admin. | | `--project ` | none | Only those whose registration allows this project. | Every command also takes the [global flags](https://docs.kindgi.com/v0.3.1/reference/cli.md#global-flags). **Examples** List your own connections to Google, as a table. ```sh kindgi connections list --app=google --mine --table ``` List the connections a project's registrations allow. ```sh kindgi connections list --project= ``` List connections, removed ones too, as a table. ```sh kindgi connections list --include-removed --table ``` **See also** - [Connect your apps](https://docs.kindgi.com/v0.3.1/guides/connections.md) - [How connections work](https://docs.kindgi.com/v0.3.1/guides/connections/reference.md) - [`kindgi connections`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections) ### `kindgi connections get` **Synopsis** ```sh signature kindgi connections get ``` One connection: whose account it is, its permissions and its state. **Options** Every command also takes the [global flags](https://docs.kindgi.com/v0.3.1/reference/cli.md#global-flags). **Examples** Show one connection: whose account, its permissions and its state. ```sh kindgi connections get ``` **See also** - [Connect your apps](https://docs.kindgi.com/v0.3.1/guides/connections.md) - [How connections work](https://docs.kindgi.com/v0.3.1/guides/connections/reference.md) - [`kindgi connections`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections) ### `kindgi connections connect` **Synopsis** ```sh signature kindgi connections connect [--app-id=] [--project=] [--permissions=,…] [--for-company] ``` Connect your account at an app (the company's with --for-company): prints the link to open, and at a terminal waits until the connect finishes and says whose account it is. --quiet prints the link alone, and still waits. **Options** | Option | Default | Description | | ----------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--app-id ` | none: the app's one registration | Which registration, when the tenant has more than one for the app. | | `--for-company` | off | Connect the company's account, not your own. Tenant admins only. | | `--permissions ` | none picked: at a terminal it asks about each one the app's entry offers; required without one | The entry's permission keys to ask for, comma-separated (`gmail.send,gmail.readonly`). Left out, it asks you at the terminal about each one the app's entry offers, none picked for you; without a terminal it's required. | | `--project ` | none | The project it's for; the registration must allow it. | Every command also takes the [global flags](https://docs.kindgi.com/v0.3.1/reference/cli.md#global-flags). **Examples** Connect your Google account to send email; open the link it prints. ```sh kindgi connections connect google --permissions=gmail.send ``` Connect the company's GitHub installation for a project (tenant admins). ```sh kindgi connections connect github --project= --for-company ``` From [Connect your apps](https://docs.kindgi.com/v0.3.1/guides/connections.md): ```sh npx --yes @kindgi/cli@0.2 connections connect google --permissions=gmail.send ``` **See also** - [Connect your apps](https://docs.kindgi.com/v0.3.1/guides/connections.md) - [`kindgi connections`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections) ### `kindgi connections disconnect` **Synopsis** ```sh signature kindgi connections disconnect [--yes] ``` Disconnect: withdraws the access at the app where it can, destroys the token, and prints what was done. Asks first, unless --yes. **Options** | Option | Default | Description | | ------- | ------- | ------------------------------ | | `--yes` | off | Don't ask first (for scripts). | Every command also takes the [global flags](https://docs.kindgi.com/v0.3.1/reference/cli.md#global-flags). **Examples** Disconnect a connection without being asked (for scripts). ```sh kindgi connections disconnect --yes ``` From [How connections work](https://docs.kindgi.com/v0.3.1/guides/connections/reference.md): ```sh npx --yes @kindgi/cli@0.2 connections disconnect ``` **See also** - [How connections work](https://docs.kindgi.com/v0.3.1/guides/connections/reference.md) - [`kindgi connections`](https://docs.kindgi.com/v0.3.1/reference/cli/connections.md#kindgi-connections)