Documentation

Getting Started with Instructionly

Instructionly is a developer tool that enables teams to set role-specific instructions and connect them to AI-powered IDEs via MCP (Model Context Protocol).

What is Instructionly?

Instructionly turns scattered knowledge into actionable, in-IDE guidance. Define and manage instructions from coding guidelines to onboarding steps and architectural notes—ensuring knowledge is always up to date and accessible.

Workspace Management

Create and manage multiple workspaces for different teams or projects.

Skills & Instructions

Define AI-ready coding guidelines, patterns, and best practices.

Team Collaboration

Invite team members with role-based access control.

MCP Integration

Connect to Claude Code, Cursor, and Windsurf IDEs.

Credit-Based Billing

Flexible pay-as-you-go pricing with credit packs.

Activity Tracking

Full audit log of all workspace changes.

Meet ion

ion is the heart of Instructionly — our mascot, our logo, and the command that brings your instructions to life. The name comes from the atomic particle that carries charge and creates bonds.

Just like ions connect atoms to form molecules, ion connects your knowledge to AI — creating a bond between your standards and every AI interaction.

When you say "ion" to your AI assistant, you're activating Instructionly. ion analyzes your request, fetches the right instructions from your workspace, and delivers them on-demand — no wasted tokens, no repeated context.

ion is Instructionly, distilled into three letters.

Supported AI Tools

Instructionly seamlessly integrates with your favorite AI-powered tools:

IDEs

  • Claude Code — Anthropic's official CLI for AI-assisted development
  • Cursor — The AI-first code editor built for productivity
  • Windsurf — AI-powered IDE with intelligent code completion and chat

Chat Interfaces

  • ChatGPT — OpenAI's conversational AI assistant
  • Claude Desktop — Anthropic's desktop app for conversations with Claude
  • Gemini — Google's AI assistant

Plus any tool supporting Model Context Protocol (MCP).

Quick Start

Get up and running with Instructionly in just a few minutes.

Get your MCP credentials

Sign up and generate your MCP Key and Secret to connect Instructionly with your AI tools.

MCP Keys are user-scoped

MCP keys are tied to your user account, not individual workspaces. Use the same key with different workspace values to access multiple workspaces.

Install the CLI

Install the Instructionly CLI and configure it with your credentials.

Configure your AI tool

Follow the setup guide for your preferred tool: Cursor, Claude Code, Windsurf, ChatGPT, Claude Desktop, or Gemini.

Next Steps