# TUI Source: https://alysiscode.com/docs/cli Run Alysis from your terminal to ask about a repository, edit code, or give it a task from a script. ## Install With Python 3.11 or newer and pipx installed: ```bash pipx install alysis-code alysis --version ``` For the shell installer, uv, or Windows setup, see [installation](/docs/getting-started/installation). ## Start a chat ```bash cd your-project alysis ``` The first launch walks you through connecting a provider, choosing a model, and checking the workspace and sandbox. Use `alysis setup` to run setup again. Try a question about the project: ```text Where does this app handle sign-in? Explain the relevant files without changing them. ``` Continue in the same chat to ask questions or request a change. [Your first TUI task](/docs/getting-started/first-run) covers permissions and file references. ## Run one task Use `alysis run` when you want to give an instruction from the shell: ```bash alysis run --mode readonly "Explain this project's structure and main entry points." ``` For edits, model overrides, or automation, see [alysis run](/docs/cli/run). ## Find a command Type `/` in a chat to see commands, or use `/help`. The [terminal controls guide](/docs/cli/interactive) covers reviewing diffs, searching chats, and resuming work. From the shell, add `--help` to a command: ```bash alysis --help alysis run --help ``` Use [configuration](/docs/cli/config) to change settings and [alysis update](/docs/cli/update) to check for a new version. :::info These docs cover the current TUI source. Your installed package may be older. Check `alysis --version` and the command's `--help` output if an option is missing. :::