Ghosty
Documentation
Getting started

Getting started

Create an agent, hand it a PDF and watch it download it to its machine, read it and answer with the exact figures. Ten minutes, no code.

Updated 2026-09-16

When you finish you will have an agent with its own machine —disk, terminal, memory— that has already read a document of yours and answered with exact dates and amounts. Every step shows the real screen you will see.

Before you start

An account at (Google, Apple or email). Nothing else.

AgentName, identity and engine. It is yours; it works wherever you activate it.
MachineIts disk and terminal. Sleeps on its own, wakes on the first message.
ChannelHow you talk to it: the Studio chat, Teams, your editor or your software.

1. Create the agent

In Agents press + Nuevo agente (New agent). One row appears with three things: name, engine and Crear (Create).

New agent form: name, engine and Create button

For this guide pick the engine Ghosty · Lite: it is the one with chat inside Studio. (Claude and DeepSeek are used from Teams and WhatsApp; they have no "Hablar" button in the list.)

On create, Studio provisions its machine. When the agent shows up in the list with Hablar (Talk), it is ready.

Agent row in the list with the Hablar button

2. Hand it a document

Press Hablar. In the chat, attach a PDF with the clip (or drag it in) and type:

text
Summarize this document in three points and tell me which dates and amounts appear.
Chat composer with a PDF attached

3. Watch what it does

The first time takes a few seconds: it says "despertando la caja" (waking the machine) while it boots. Then you see every tool it uses, in order. With this message it is two terminal commands: download the file and read it with pdf-reader.

Two Terminal calls, marked as completed

And the answer: not a vague summary, but the dates and amounts that are in the document.

Agent reply with three key points, exact dates and amounts

You can close the tab mid-turn: the work runs on its machine and the answer is there when you come back.

4. Choose where else it works

In Agents → your agent is its card: model, identity and channels.

Agent card: Ghosty Teams channel and ACP connection block
  • Ghosty Teams — flip the switch and give it an @handle in : it reads the channels where it is mentioned and works with documents and forms.
  • Your editor — Generar token gives you the block for Zed or VS Code; the same agent, same machine, over .
  • Your coding agent — with that same token, Claude Code or Cursor set its identity, files, skills and MCPs: .
  • Your software — the with OAuth2.
  • WhatsApp — turn on the channel and tick the number it serves; the number is connected once from Sales. Guide: .

What just happened

  • An isolated machine was created just for your agent.
  • The PDF did not travel inside the message: it was uploaded to your library and the agent downloaded it to its disk through a signed URL that expires.
  • The agent chose the tools (terminal, pdf-reader) and ran them there; you saw every step.

Next steps

  • : turns, permissions, connectors, skills, engines.
  • : put it to work with your team.
  • Ask for something bigger: "Make a one-page document with this summary" returns a .docx.
  • : what isolates your agent and where your keys live.
Next →
Concepts