Skip to main content

Getting Started

Install the io-intelligence skill, then describe your io.Intelligence goal to your AI coding agent. The agent will use the skill when the request matches its supported workflows.

Prerequisites​

To install and use the kit, you need:

  • an AI coding agent that supports the Agent Skills specification;
  • Node.js and network access to run the Skills CLI installation command;
  • Git and Node.js 18 or newer when materializing an official application template.

You don't need an Agent Protocol backend to install the kit, learn about io.Intelligence, inspect a project, diagnose an integration, materialize a template, or work on a backend adapter.

Additional requirements apply when you run an assistant application:

  • an io.Connect Browser or io.Connect Desktop environment is needed to inspect io.Connect-integrated behavior;
  • a valid AGENT_SERVER_URL is required before starting any V1 template application.

The URL must point to an LLM agentic backend that implements the io.Intelligence Agent Protocol. Creating that underlying agentic backend is outside the kit's scope. If you already have one, the kit can help you configure AI Mastra Bridge or implement a custom bridge adapter.

Install the Skill​

Run the open Skills CLI from your development environment:

npx skills add InteropIO/iointel-dev-kit --skill io-intelligence

To inspect the skills exposed by the repository before installing:

npx skills add InteropIO/iointel-dev-kit --list

Your coding agent should now recognize requests involving io.Intelligence, io.Assist, AI Web, MCP, Working Context, AI Mastra Bridge, and the Agent Protocol. The exact way installed skills are displayed depends on the agent you use.

Try a First Request​

Give the agent your desired outcome and relevant constraints. For example:

Help me understand which io.Intelligence packages I need to add an assistant to this project. Inspect the project first and explain your recommendation before making changes.

For a new application, ask the agent to select and materialize an official template:

Create a new packaged React io.Assist application in ./assistant-app using the official io.Intelligence template. Do not start it until I provide the agent server URL.

For an existing backend:

I already have an agentic backend. Help me determine whether AI Mastra Bridge fits it or whether I need a custom adapter for the io.Intelligence Agent Protocol.

You can also ask the agent to guide you through the io.Assist Anywhere guide, answer questions about a chapter, or investigate where your implementation differs from the guide.

Before Starting a Template​

Every V1 template intentionally contains an empty AGENT_SERVER_URL. Before the application is started:

  1. provide or identify a valid Agent Protocol backend URL;
  2. let the coding agent locate the setting in the materialized project;
  3. configure it without committing secrets or inventing a placeholder URL;
  4. use the project's own scripts and io.Connect configuration to determine how it should run.

An empty URL doesn't prevent you from installing the kit, materializing the template, reviewing its source, or building it when the project defines a build command. It blocks starting the assistant application because the application can't communicate with an agentic backend.

Next, learn the main ways to use the AI Dev Kit or compare the available application templates.