Getting Started

Introduction

Get Agently installed and running on your machine in under 5 minutes.

1. Download Agently

Agently is available for macOS (Apple Silicon and Intel) and Windows. Download the latest release from the official site.

  • macOS: Download the .dmg file, open it, and drag Agently to your Applications folder.
  • Windows: Download the .exe installer and run it. Windows may show a SmartScreen warning for unsigned builds — click "More info" then "Run anyway".

2. First Launch & License

On first launch, Agently will ask you to enter your license key. You received this key by email after purchasing. Enter it in the activation dialog.

Your license is tied to one machine. If you need to transfer it to a new machine, contact info@marunouchi.co.

Note: Agently does not require an internet connection after activation, except for AI API calls and optional sync features.

3. Connect an AI Provider

Agently works with any OpenAI-compatible API. On first run, the onboarding wizard will guide you through connecting your preferred provider:

  • OpenAI — Paste your API key from platform.openai.com
  • Anthropic Claude — Paste your API key from console.anthropic.com
  • Google Gemini — Paste your API key from aistudio.google.com
  • Local models — Point to a local Ollama or LM Studio endpoint

Your API keys are stored locally on your machine using the system keychain. They are never sent to Agently's servers.

4. Your First Conversation

Click New Chat (or press ⌘N) to start a conversation. Type your message and press Enter to send.

You can attach files by dragging them into the chat window, or click the attachment icon in the toolbar.

To invoke a skill, type @skill-name at the start of your message. See the Skills documentation for details.

5. Explore the Interface

Agently's main interface has three areas:

  • LLeft sidebar — Conversation list, workspaces, and navigation. Filter by labels or statuses.
  • CCenter — The active conversation. Messages, tool calls, and agent output appear here.
  • RRight panel — Context and details. Shows active sources, skills, conversation metadata, and settings.