Quickstart

Before you begin

Make sure you have:

• Node.js 22.9 or newer if you use the recommended npm install
• Developer Mode enabled in ChatGPT

Glossa can modify files and run commands on your computer. Review the security model.

Step 1: Install Glossa

npm install --global @ariobarin/glossa@beta

irm https://glossa.sh/install | iex

curl -fsSL https://glossa.sh/install.sh | sh

curl -fsSL https://glossa.sh/install.sh | sh

Confirm Glossa is available:

glossa --version

After Glossa starts, press u to install the newest beta. You can also run glossa update directly.

Step 2: Start a workspace

Open a terminal in the folder where you want ChatGPT to work:

glossa

Keep this terminal open. Closing it disconnects that local workspace from ChatGPT.

Step 3: Connect ChatGPT

1. Open Settings > Plugins/Apps and enable Developer Mode.
2. Choose Create.
3. Name the app Glossa and enter this MCP server URL:

https://mcp.glossa.sh/mcp

4. Choose OAuth.
5. Sign in with the same Google account used by the Glossa CLI, then choose Create.

Step 4: Verify the connection

Press s in Glossa to check the account, relay, enrolled device, and active worker. Press Esc to return to the workspace view. You can also run glossa status in another terminal.

Try a read

In ChatGPT, select Glossa and send:

Use Glossa to list my connected workspaces.

If Glossa lists the workspace, the connection is ready. Ask it to read a file next.

What next

• Read why Glossa works this way.
• Review the complete security model.
• Visit support if the worker, OAuth flow, or app does not connect.