# Jinn > Jinn runs Linux VMs as functions and persistent SSH machines. With an agent function: you send a prompt and an input folder (.tar.gz); the agent works until the files you asked for exist; Jinn returns them as one .tar.gz. Without an agent: the VM is yours to drive with commands (bash, read, write, edit, list, put, get, finish). A machine is a persistent Linux VM with a fixed SSH address (`@ssh.usejinn.com`) that wakes automatically on SSH and saves its disk when idle. Work is defined once as a function (image, setup commands, environment, size, timeout, input and output manifests, whether to save the disk as an image, and an optional agent: model provider, system prompt, tools) and called many times as runs. Persistent machines (`jinn machine create`, `jinn ssh-key init`) are backed by image lineages and accept standard OpenSSH, SFTP, and loopback port forwarding (`[user+]@ssh.usejinn.com`). Use Jinn from SSH, the `jinn` CLI, the HTTP API at https://api.usejinn.com/v1, or the Go and TypeScript SDKs. Sign up at https://app.usejinn.com with an email address; runs and machines are paid from prepaid credit, and the first account starts with $5 of it. ## Docs - [Docs index for agents](https://docs.usejinn.com/llms.txt): every page as Markdown - [All docs in one file](https://docs.usejinn.com/llms-full.txt) - [Machines and SSH](https://docs.usejinn.com/machines.md): persistent SSH VMs with wake-on-connect and idle auto-save - [Use Jinn from an agent](https://docs.usejinn.com/agents.md): the CLI's JSON mode, exit codes, API error codes - [Quickstart](https://docs.usejinn.com/quickstart.md) - [OpenAPI document](https://docs.usejinn.com/openapi.json) ## Code - [jinn-cli](https://github.com/usejinn/jinn-cli): the `jinn` command - [jinn-go](https://github.com/usejinn/jinn-go): `go get usejinn.com/go` - [jinn-node](https://github.com/usejinn/jinn-node): the TypeScript SDK ## Legal - [Terms](https://usejinn.com/terms), [Privacy](https://usejinn.com/privacy), [Acceptable use](https://usejinn.com/acceptable-use)