moving

docs/GETTING-STARTED.md

@@ -0,0 +1,92 @@
+# Getting Started with Waggle
+
+Welcome to Waggle — your AI operating system with persistent memory.
+
+## Quick Start (5 minutes)
+
+### 1. Install Waggle
+Download the desktop app for your platform:
+- **Windows**: Download the `.msi` installer
+- **macOS**: Download the `.dmg` installer
+
+Run the installer and launch Waggle.
+
+### 2. Set Up Your API Key
+- Open Waggle — the onboarding wizard appears on first launch
+- Get an Anthropic API key at https://console.anthropic.com/settings/keys
+- Paste it in the wizard and click "Validate & save"
+
+### 3. Create Your First Workspace
+- Choose a template (Sales, Research, Legal, etc.) or start blank
+- Pick a persona (Researcher, Writer, Analyst, etc.)
+- Name your workspace
+
+### 4. Start Working
+Type anything in the chat. Your agent can:
+- Search the web (works immediately, no setup)
+- Create Word documents with professional formatting
+- Read and write files in your workspace
+- Run shell commands (sandboxed)
+- Run 15 workflow commands (type `/` to see them)
+- Remember everything across sessions
+
+### 5. The Memory Magic
+After your first conversation, try closing and reopening the workspace.
+Type: "What do you remember about our discussion?"
+Your agent remembers everything — decisions, context, preferences.
+
+## Key Features
+
+### Workflow Commands
+Type `/` in chat to see all commands:
+- `/research [topic]` — deep web research with synthesis
+- `/draft [type]` — create documents with professional formatting
+- `/plan [goal]` — structured planning with steps
+- `/catchup` — get a summary of where things stand
+- `/decide [question]` — structured decision analysis
+- `/review [topic]` — review work or documents
+- `/spawn [task]` — delegate work to a sub-agent
+- `/skills` — browse and install new capabilities
+- `/status` — workspace health and statistics
+- `/memory` — explore what your agent remembers
+- `/focus` — set the current work focus
+- `/now` — quick workspace snapshot
+- `/help` — see all available commands
+
+### Personas
+Press `Ctrl+Shift+P` to switch personas. Each changes how your agent thinks:
+- **Researcher**: deep investigation with citations
+- **Writer**: document creation with formatting
+- **Analyst**: data analysis with structured output
+- **Planner**: project planning and task breakdown
+- ...and more
+
+### Keyboard Shortcuts
+- `Ctrl+K` — search everything
+- `Ctrl+Shift+1` through `Ctrl+Shift+7` — switch views
+- `Ctrl+Shift+P` — switch persona
+- `/` — workflow commands
+
+### Memory View
+Press `Ctrl+Shift+5` to browse everything your agent remembers.
+Search, filter by type, and explore the knowledge graph.
+
+### Workspace Home
+When you open a workspace, you see the "Workspace Now" overview:
+- A summary of where things stand
+- Recent decisions and open items
+- Recent conversation threads
+- Key memories
+
+Once you start chatting, click the **Workspace Overview** toggle above the messages to return to this view at any time.
+
+## Product Scopes
+
+Waggle works across four product scopes:
+- **Solo** — personal productivity with persistent memory
+- **Teams** — shared workspaces with collaboration
+- **Business** — team management, analytics, and governance
+- **Enterprise** — full KVARK integration, compliance, and audit trails
+
+## Need Help?
+Type `/help` in chat for a full command reference.