Quick Start Guide¶

Welcome to Glassy—your workspace designed for minds that think differently. This guide will have you capturing ideas in under 5 minutes.

What You'll Create¶

By the end of this guide, you'll have: - A Glassy account - Your first note - Understanding of the core interface - (Optional) The Second Brain / MCP server connected to your favorite AI assistant or agent — Claude, Cursor, Windsurf, OpenCode, Hermes, Openclaw, Pi, or any other MCP-compatible client

Step 1: Create Your Account¶

Navigate to the sign-up page and enter your email. You'll receive a confirmation email—click the link to verify your account.

:::info Google sign-in is available if your server admin has configured it. Otherwise, use your email and password. :::

Step 2: Explore the Interface¶

The main areas you'll use:

Area	Purpose
Workspace	Where all your notes live
Account HUD	Access account, settings, storage
Search	Find anything across all notes
Keep	Save and read captured web content
New Note	Create fresh notes instantly

The sidebar is organised into Views (Today, Notes, Documents, Recording) and Organize (Keep, Following, Tags, Archive). The Account HUD slides up from the bottom of the screen, showing your storage usage, subscription status, and quick access to settings.

Step 3: Create Your First Note¶

Select New Note (or press Cmd/Ctrl + N)
Give your note a title
Start typing

Your note saves automatically as you write. No manual saving required.

:::success Notes sync across all your devices within seconds. :::

Step 4: Try Slash Commands¶

Slash commands let you insert content quickly. In any note, type / to open the command palette:

/h2 — Insert a heading
/bullet — Start a bulleted list
/info — Add an info callout
/todo — Create a checklist

Understanding the Account HUD¶

The Account HUD is your control center. Slide it up to access: - Storage usage and limits - Subscription management - Security settings (including 2FA) - Notification preferences - Sign out

:::warning Your storage limit shows in amber, not red. Amber means you're near your limit but nothing is deleted—archive older notes to make room. :::

Next Steps¶

Install the Glassy Companion browser extension from the download page
Explore the workspace using the sidebar (Today, Notes, Documents, Recording)
Keyboard Shortcuts — Work faster
Second Brain / MCP — Expose your knowledge base to Claude, Cursor, Windsurf, OpenCode, Hermes, Openclaw, Pi, and any MCP-compatible AI agent
Self-hosting — Run Glassy on your own machine with the 0Reliance/glassy-selfhost appliance.

Try the MCP Server (Optional, 2 minutes)¶

If you have an MCP-compatible AI assistant installed — Claude Desktop, Cursor, Windsurf, OpenCode, Hermes, Openclaw, or Pi — you can connect it to your Glassy knowledge base right now:

In Glassy, go to Settings → Integrations → MCP Keys and click Generate Key.
Copy the config snippet for your AI tool. If you have the Glassy Companion extension (v2.13.0+) installed, it can show the live MCP config snippet directly in Settings → Integrations.
Paste it into your AI tool's MCP config file and restart the tool.
Ask the AI: "Search my Glassy bookmarks for…" — it will use the glassy_search tool to query your knowledge base.

See the full Second Brain / MCP guide for the complete tool list, prompts, and resources.

Try the Obsidian Bridge (Optional)¶

If you use Obsidian, the Glassy Companion extension can act as a local bridge between the Glassy server and Obsidian, solving WSL2/Docker networking issues. See the Obsidian vault guide.

Need Help?¶

Troubleshooting — Fix common problems
FAQ — Frequently asked questions (being expanded)