# Flisk

> Flisk puts little games, films and worlds on a person's screens (TVs, computers, phones, browsers) and changes them
> as they ask. An AI agent can do the same for the person it works for, through Flisk's MCP server or command line.

Everything here acts as one person, with an access token of theirs, on their own screens only. Accounts are made in
the Flisk app on iPhone or Android; an agent can't make one.

## Connect

- MCP server: https://flisk.tv/mcp (Streamable HTTP, JSON-RPC 2.0). Send `Authorization: Bearer <token>`. The person makes the
  token in the Flisk app (Settings, Connect your agent) or with `flisk tokens new NAME`.
- Command line: `curl -fsSL https://flisk.tv/install | sh`, then `flisk login`. `flisk connect` adds Flisk's MCP server to
  Claude Code or Codex; `flisk connect show` prints the setting for other clients.
- [Connect your AI (MCP)](https://flisk.tv/docs/mcp.md): the same, in full.
- [The command line](https://flisk.tv/docs/cli.md): installing it, signing in, the commands.

## Using it well

- Call `explain` first: what Flisk is and how to drive it. (`flisk explain` at a shell says the same.)
- `screens` lists the person's screens and whether each is on. Name the screen in each call.
- `reference` says what a scene can hold. Start something new from `templates`, show it with `show_scene`, then change
  it with `apply_ops`; read it with `get_scene` before changing it.
- Check your work with `picture` (an image of the screen) or `look` (words).
- A refusal says why, as {"error": code, "detail": words}. `offline` means the screen isn't connected.
- `tools/list` gives every tool and its parameters, live.

## Keeping up

- [Releases](https://flisk.tv/releases.txt): what's new in each release, newest first, as plain text. Read it to learn what
  changed since you last looked. (Also https://flisk.tv/releases and the feed https://flisk.tv/releases/feed.xml.)
- [Blog](https://flisk.tv/blog): news from Flisk (feed: https://flisk.tv/blog/feed.xml).

## Docs

Every page of the docs and help is also its own Markdown: add `.md` to its address.

- [How Flisk works](https://flisk.tv/docs/overview.md): Screens, scenes, ops and agents: the few ideas everything else is built on.
- [Quickstart](https://flisk.tv/docs/quickstart.md): From nothing to your AI drawing on your TV in about five minutes.
- [Connect your AI (MCP)](https://flisk.tv/docs/mcp.md): Connect Claude, Codex, Cursor or any MCP client to Flisk, so your AI can put scenes on your screens and change them, as you.
- [The command line](https://flisk.tv/docs/cli.md): flisk, Flisk from a terminal: your screens, scenes and library, for you or an AI agent working on your computer.
- [Building scenes](https://flisk.tv/docs/scenes.md): The way to make and change things on a screen well, and to check your work.
- [Tools](https://flisk.tv/docs/tools.md): The tools Flisk gives an agent, by what they're for. tools/list has every one, live.
- [Errors and refusals](https://flisk.tv/docs/errors.md): What a refusal looks like, and what to do about the common ones.
- [Tokens and security](https://flisk.tv/docs/tokens.md): How access tokens work, and keeping them safe.
- [Keeping up with changes](https://flisk.tv/docs/keeping-up.md): Where to find what's new in Flisk, for people and for agents.

## Optional

- [Help](https://flisk.tv/help): for people using Flisk.
  - [Getting started](https://flisk.tv/help/getting-started.md): Get the app, sign in, and put your first Flisk on a screen.
  - [Your screens](https://flisk.tv/help/screens.md): Add your TV, computer and browser to Flisk, name them, and choose what's on each.
  - [Make something](https://flisk.tv/help/making.md): Ask Flisk's agent for a game, a film or a world, change it, point at things, and keep what you love.
  - [Parties](https://flisk.tv/help/parties.md): Play together round one screen, with each phone as a player. Guests need no app.
  - [Share what you make](https://flisk.tv/help/sharing.md): Send anyone a link to a Flisk, put one on your website, and invite your friends.
  - [Credits](https://flisk.tv/help/credits.md): What credits are, how to get them, and what to do if a purchase didn't arrive.
  - [Your account](https://flisk.tv/help/account.md): Signing in, signing out and deleting your account.
  - [Safety and reporting](https://flisk.tv/help/safety.md): Report something that shouldn't be on Flisk, and how we keep people safe.
  - [Contact us](https://flisk.tv/help/contact.md): Email us, or come and talk to us on Discord.
- [Get Flisk](https://flisk.tv/download): the apps.
- [Privacy](https://flisk.tv/privacy), [Terms](https://flisk.tv/terms), [Support](https://flisk.tv/support)
