Skip to main content
Before diving into NimbleBrain Studio, it helps to understand the core concepts and how they work together. This page defines the key terminology you’ll encounter throughout the platform.

​
Platform Overview

NimbleBrain Studio is an AI-native automation platform where Nira is your primary interface. Press ⌘K (Mac) or Ctrl+K (Windows) anywhere to open Nira and start building automations through conversation.

​
Key Concepts

​
Workspace

A Workspace is your isolated environment within NimbleBrain Studio. Think of it as a project folder that contains all your automations, connections, and settings.

Isolation

Each workspace is completely separate. Playbooks in one workspace cannot access data in another.

Team Collaboration

Invite team members to collaborate within a workspace with role-based permissions.
Key points:
  • All playbooks and connections are scoped to a workspace
  • API keys are workspace-specific
  • You can have multiple workspaces for different projects or teams

​
Nira

Nira is your AI assistant and the primary way to interact with NimbleBrain Studio. Instead of clicking through menus and forms, you describe what you want in natural language, and Nira builds it for you.

Primary Interface

Nira is the main way to interact with Studio. Press ⌘K (Mac) or Ctrl+K (Windows) to open Nira anywhere.

Conversation-Driven

Build automations through natural conversation. Nira understands business language, not just technical terms.
Nira can:
  • Create playbooks from natural language descriptions
  • Select and configure the right tools automatically
  • Help troubleshoot issues with your automations
  • Answer questions about the platform
  • Search and navigate your workspace
Example: “Create a playbook that checks our GitHub repository for new issues every hour and posts a summary to Slack” - Nira will build this entire automation for you.
Learn more about Nira

​
Playbook

A Playbook is an AI-powered automation defined in natural language. It’s the fundamental building block of all automations in NimbleBrain Studio.

Natural Language

Write instructions as if explaining to a colleague. The AI interprets and executes them.

Tool Access

Playbooks can use any connections installed in your workspace.
Playbook components:
  • Instructions: Natural language description of what the playbook should do
  • Configuration: AI model, temperature, timeout settings
  • Schedule: Optional recurring execution (daily, hourly, etc.)
  • Status: Active or inactive
  • Execution history: Log of all runs with results
Example playbook instructions: 
You are a stock advisor. Analyze the latest market news from Finnhub
and recommend the top 3 stocks expected to provide the greatest
returns over the next week. Include your reasoning for each pick.
Learn more about Playbooks

​
Connection

A Connection is an integration that gives your playbooks access to external APIs and services. Think of connections as the “tools” your automations can use.

Integrations

Each connection provides access to specific tools and services like Slack, GitHub, or databases.

One-Click Install

Install from the catalog instantly. Nira can also auto-install required connections.
Available connection categories:
  • Business & Collaboration: Slack, Gmail, Google Sheets, HubSpot, Zoom, Calendly
  • Developer Tools: GitHub, documentation search
  • Data & Analytics: PostgreSQL, ClickHouse
  • Finance: Finnhub (stock data)
  • Utilities: Weather, translation, PDF processing
Important: Playbooks can only use connections that are installed in your workspace. Install the connections you need before creating playbooks that use them. Browse all Connections

​
Scheduling

Scheduling allows your playbooks to run automatically at specified times or intervals without manual intervention.

Time-Based

Run at specific times: daily at 9am, weekdays at 8am, first of month

Interval-Based

Run at regular intervals: every 15 minutes, hourly, every 6 hours
Schedule types:
  • Time-Based: Specific times (e.g., “Every Monday at 9am”)
  • Interval-Based: Regular intervals (e.g., “Every 15 minutes”)
  • Event-Triggered: Run when webhooks receive data
Learn more about Scheduling

​
Execution

An Execution is a single run of a playbook. Each time you run an automation (manually or on schedule), it creates an execution record. Execution details include:
  • Status: Running, completed, or failed
  • Duration: How long it took
  • Steps: Each action the AI took
  • Tool calls: Which integrations were used
  • Result: The final output
You can view all executions in the Activity Logs section. View Activity Logs

​
API Key

An API Key (also called API Token) allows external applications to interact with your workspace programmatically. Use API keys to:
  • Run playbooks from external systems
  • Connect Claude Desktop to your workspace
  • Integrate with CI/CD pipelines
  • Build custom applications using the SDK
API keys grant access to your workspace. Keep them secure and never share them publicly.
Manage API Keys

​
How Concepts Relate

Here’s how everything fits together:

​
Common Workflows

  1. Open Nira (⌘K)
  2. Describe what you want to automate
  3. Nira installs required connections
  4. Nira creates the playbook
  5. Click “Run” to test it
  1. Tell Nira: “Create a daily report that…”
  2. Nira creates the playbook with scheduling
  3. Configure the schedule (time, frequency)
  4. Playbook runs automatically
  1. Go to Connections
  2. Click “Connect” on a server
  3. Copy the configuration
  4. Paste into Claude Desktop config
  5. Restart Claude Desktop

​
Glossary Quick Reference

TermDefinition
WorkspaceIsolated environment containing all your automations
NiraAI assistant for building and managing automations (⌘K)
PlaybookAI-powered automation with natural language instructions
ConnectionIntegration providing access to external APIs and services
SchedulingAutomatic recurring execution of playbooks
ExecutionSingle run of a playbook
API KeyToken for programmatic workspace access

​
Next Steps

Quickstart Guide

Build your first automation in 5 minutes

Meet Nira

Learn how to work with your AI assistant

Browse Connections

See what tools are available

Playbook Examples

Explore playbook patterns and best practices