# The command line

> flisk, Flisk from a terminal: your screens, scenes and library, for you or an AI agent working on your computer.

`flisk` is Flisk from a terminal: your screens, scenes and library, for you or for an AI agent working on your
computer. It needs Python 3.9 or later.

## Install

```sh
curl -fsSL https://flisk.tv/install | sh
```

Run the same again to update it.

## Sign in

You'll need a Flisk account: make one in the Flisk app on [iPhone or Android](/download) first.

```sh
flisk login
```

Scan the code it shows with the Flisk app, or approve it in a browser.

## A few things to try

```
flisk screens                          your screens, and which are on
flisk show --example shapes --to "TV"   put a scene on a screen
flisk chat "make it snow" --to "TV"     ask Flisk to change it
flisk capture --to "TV"                 a picture of what's showing
flisk explain                          how Flisk works, for you or your agent
flisk --help                           everything else
```

## Working on a scene from a file

```sh
flisk watch scene.json --to "TV"
```

keeps the screen in step with the file as you edit it. Each change goes as ops, so the scene carries on and its
camera stays where it is.

## More commands

| Command | What it does |
| --- | --- |
| `flisk apply` | change what a screen is showing, with ops |
| `flisk preview` | a picture of a scene as it would look, with no screen |
| `flisk try` | run a scene's script for a moment, with sample data and a press |
| `flisk check` | check a level can be finished, and fits the smallest screens |
| `flisk reference` | how to write scenes and ops |
| `flisk schema` | every kind and what it takes, as JSON |
| `flisk tools`, `flisk tool` | every agent tool, and calling any of them |
| `flisk library` | the public library: search, show, get, contribute |
| `flisk asset` | your own pictures, models and sounds |
| `flisk pair` | add a screen by the code it shows |
| `flisk tokens` | access tokens for your agents |
| `flisk events` | what's been pressed on a screen |

`flisk --help` lists everything, and `flisk COMMAND --help` says more about each.

## Give it to your AI

```sh
flisk connect
```

Adds Flisk to Claude Code, signed in as you. [Connect your AI](/docs/mcp) has the rest.
