iblai/vibe

Mirrored from iblai/vibe · README.md. This page is generated — edit it in the repository, not here.

Ship AI-powered apps fast — and run the platform behind them. Backend included.

Release Skills Next.js TypeScript Tailwind CSS Claude Code OpenAI Codex Cursor Desktop & Mobile License: MIT

Note: This toolkit runs against the hosted iblai.app environment. If you'd like a license to the full platform codebase to run locally or self-host, reach out to our team at ibl.ai/contact.

---

Build the app you actually need on ibl.ai — sign-in, an AI agent to talk to, users and admins, custom data, memory, analytics, billing — as a website and as macOS, Windows, iOS, and Android apps. Or run the platform with no UI at all. One install; your coding agent does the rest.

Three steps

1. Install the skills in the agent you already use.

npx skills add iblai/vibe --all        # Claude Code, OpenAI Codex, Cursor, OpenCode, Copilot …

Claude Code users can install the plugin instead (same skills, plus the SDK-docs MCP server, updated with /plugin update): /plugin marketplace add iblai/vibe then /plugin install iblai-vibe@iblai.

2. Say hello.

/iblai-vibe-connect
/iblai-vibe-auth
/iblai-vibe-agent-chat
/iblai-vibe-project
/iblai-vibe-profile
/iblai-vibe-account
/iblai-vibe-analytics
/iblai-vibe-notification
/iblai-vibe-invite
/iblai-vibe-workflow
/iblai-vibe-local-llm
/iblai-vibe-course-access
/iblai-vibe-course-create
/iblai-vibe-onboard
/iblai-build
/iblai-test
/iblai-vibe-ops-upgrade
/iblai-vibe-rbac
/iblai-vibe-agent-search
/iblai-vibe-agent-setting
/iblai-vibe-agent-access
/iblai-vibe-agent-api
/iblai-vibe-agent-dataset
/iblai-vibe-agent-disclaimer
/iblai-vibe-agent-embed
/iblai-vibe-agent-history
/iblai-vibe-agent-llm
/iblai-vibe-agent-memory
/iblai-vibe-agent-prompt
/iblai-vibe-agent-safety
/iblai-vibe-agent-task
/iblai-vibe-agent-tool

What each skill does:

• /iblai-vibe-connect -- connects the project to an ibl.ai organization via a one-click browser flow, writing the org key + a minted API token into the env files (the token never passes through the chat). Runs first, before building.
• /iblai-vibe-auth -- adds authentication and configures the app for ibl.ai login.
• /iblai-vibe-agent-chat -- adds the full in-process agent chat surface.
• /iblai-vibe-project -- adds the in-process Projects surface (project landing page with chat input, files, instructions, assigned agents).
• /iblai-vibe-profile -- adds profile UI and profile settings flows.
• /iblai-vibe-account -- adds account and organization settings.
• /iblai-vibe-analytics -- adds analytics dashboards and reporting views.
• /iblai-vibe-notification -- adds notifications UI and notification center flows.
• /iblai-vibe-invite -- adds user invitation dialogs for tenant admin.
• /iblai-vibe-workflow -- adds workflow builder components (sidebar, modals, connectors).
• /iblai-vibe-local-llm -- defines the contract for adding on-device LLM inference (Ollama / Foundry) to a Tauri desktop build: Tauri command names, event names, and the React hook shape the SDK consumes via localLLMProps.
• /iblai-vibe-course-access -- adds edX course-content pages with outline sidebar, tab strip, iframe, and access control.
• /iblai-vibe-course-create -- drives the ibl.ai Course Creation API to programmatically generate, edit, and publish edX courses.
• /iblai-vibe-onboard -- designs and builds a high-converting questionnaire-style onboarding flow.
• /iblai-vibe-ops-build -- builds and runs the app on desktop and mobile (iOS, Android, macOS, Surface).
• /iblai-vibe-ops-test -- validates the app before it is presented to the user.
• /iblai-vibe-ops-upgrade -- upgrades the @iblai/iblai-js SDK and vibe skills to the latest versions.
• /iblai-vibe-scaffold -- scaffolds a new app or adds features; holds the base + agent project templates and documents the assembly steps.
• /iblai-vibe-iconography -- generates every app-icon size (Tauri desktop, iOS, Windows MSIX, macOS) from a single source image.
• /iblai-vibe-windows-msix -- builds and distributes a Tauri app as a Windows MSIX package (sideloading or Microsoft Store).
• /iblai-vibe-deslop -- audits and hardens an existing codebase for production readiness (two-phase audit then safety-tiered fixes).
• /iblai-vibe-cli-maintenance -- documents the internals of the iblai CLI: commands, the Jinja2 template system, standalone-binary build, and release/publish flows.
• /iblai-vibe-rbac -- reference for the default RBAC roles (student, tenant admin, mentor editor, analytics viewer, etc.), the platform's action-definitions endpoint, and the SDK components (<Admin>, <RolesTab>, <PoliciesTab>) that render the Roles + Policies management UI.
• /iblai-vibe-agent-search -- adds the agent search/browse page (starred, featured, custom, and default agents).
• /iblai-vibe-agent-setting -- adds the agent Settings tab (name, description, visibility, copy, delete) built on AgentSettingsProvider.
• /iblai-vibe-agent-access -- adds the agent Access tab (role-based access control for editor and chat roles).
• /iblai-vibe-agent-api -- adds the agent API tab (API key management).
• /iblai-vibe-agent-dataset -- adds the agent Datasets tab (searchable dataset table with upload).
• /iblai-vibe-agent-disclaimer -- adds the agent Disclaimers tab (user agreement and advisory).
• /iblai-vibe-agent-embed -- adds the agent Embed tab (embed code, custom styling, shareable links).
• /iblai-vibe-agent-history -- adds the agent History tab (conversation history with filters and export).
• /iblai-vibe-agent-llm -- adds the agent LLM tab (model provider selection).
• /iblai-vibe-agent-memory -- adds the agent Memory tab (enable/disable memory and manage memories).
• /iblai-vibe-agent-prompt -- adds the agent Prompts tab (system prompts and suggested prompts).
• /iblai-vibe-agent-safety -- adds the agent Safety tab (moderation prompts and flagged content).
• /iblai-vibe-agent-task -- adds the agent Tasks tab (schedule automated periodic agent tasks with run logs).
• /iblai-vibe-agent-tool -- adds the agent Tools tab (enable/disable agent tools).

Security Skills

8 authorized-use security skills covering reconnaissance, source-code audits (OWASP Top 10), OSINT, disk forensics, incident triage, cloud configuration auditing, dependency vulnerabilities, and prompt-injection testing. /iblai-vibe-start

Four questions — new project or existing code · one organization, many, or none ·
who signs in · what it's about (users · memories · agents · organizations). Then
it connects your ibl.ai organization (one click in the browser, or two pasted
values — the token never enters the chat) and builds. Thirty seconds after you
sign in you are chatting with your own agent, with users, an admin area, custom
user and organization settings, memory, analytics, and billing already wired.

**3. Ship.** `/iblai-vibe-ops-deploy` gives you a URL. `/iblai-vibe-ops-build`
gives you macOS, Windows, iOS, and Android.

New to ibl.ai? [ibl.ai/join](https://ibl.ai/join) creates your account and your
organization — free to start. Want the details of every step?
[Getting started →](docs/getting-started.md)

## What you get

vibe-starter, the app `/iblai-vibe-start` sets up for the common case:

- **Sign-in** with ibl.ai SSO, pinned to your organization
- **Home is a chat** with your agent; `/agents` to browse; `/setup` to pick or create one
- **Users and admins** — profile, a User/Admin switch, an admin area (people, invites, roles, analytics, billing, memory, organization)
- **Custom data** per user and per organization, stored on the platform — no database of your own
- **Memory, analytics, notifications, billing** — the platform's own, already on the page
- **Tests** (Vitest + Playwright) and a server helper for anything the components don't cover

Every piece is a skill you can also add to an existing app.

## Six things almost every app touches

Whatever you build, you will read or write these. Each has a component skill
and a headless twin that does the same thing over REST:

| | With a screen | Headless |
|---|---|---|
| **Custom data per user** — preferences, flags, onboarding, app state | `/iblai-vibe-user-metadata` | `/iblai-api-profile-metadata` |
| **The user's profile** — name, bio, image, résumé | `/iblai-vibe-profile` | `/iblai-api-profile` |
| **Memory** — user-global, per user × agent, agent knowledge | `/iblai-vibe-memory-guide` → `/iblai-vibe-memory`, `/iblai-vibe-agent-memory` | `/iblai-api-agent-memory` |
| **Custom data per organization** — branding, toggles, defaults | `/iblai-vibe-org-metadata` | `/iblai-api-org` |
| **Agent configuration** — create; identity, visibility, capabilities | `/iblai-vibe-agent-create` → `/iblai-vibe-agent-setting` | `/iblai-api-agent-create`, `/iblai-api-agent-setting` |
| **Analytics** — usage, transcripts, costs, audit, reports | `/iblai-vibe-analytics` | `/iblai-api-analytics` |

Not sure whether you want the per-user, per-agent, or per-organization one?
[Which scope stores what →](docs/catalogue.md#core)

## The skills, by folder

Two families in one install: **🖥️ `iblai-vibe-*`** mounts a visual component in
your app; **🔌 `iblai-api-*`** does the same thing headlessly over REST — for a
script, a CI job, or your own backend. [How they differ →](docs/skill-kinds.md)

| Folder | What it covers | Skills |
|---|---|---|
| [`start/`](skills/start) | The first conversation, connecting your organization, sign-in, the starter | 11 |
| [`agents/`](skills/agents) | Chat, browse, create, and configure agents — every settings tab | 57 |
| [`users/`](skills/users) | Profiles, custom user data, memories, roles and admins, invitations | 18 |
| [`organizations/`](skills/organizations) | Organization settings and metadata, branding, integrations | 10 |
| [`billing/`](skills/billing) | How you are charged, spend caps, three ways to charge your users | 12 |
| [`analytics/`](skills/analytics) | Usage, users, topics, transcripts, costs, reports | 2 |
| [`content/`](skills/content) | Courses, catalog, credentials, admissions, Open edX Studio, avatar video | 26 |
| [`ship/`](skills/ship) | Test, deploy, hosting, native builds, app stores | 12 |
| [`security/`](skills/security) | Authorized-use security work | 8 |

The full list with one line per skill: [docs/catalogue.md](docs/catalogue.md).

## Keep it current

This repo changes often. Installed skills are a copy — refresh them with the
install command above, or `/iblai-vibe-ops-upgrade` in Claude Code (your agent
will suggest it when the copy is more than two weeks old).
[Details →](docs/keep-current.md)

## Learn more

- [Getting started](docs/getting-started.md) — the journey in detail, and what to do when you already have an app
- [How sign-in and organizations work](docs/auth-model.md) — one organization, many, or none
- [Users, agents, organizations](docs/domain-model.md) — the data every app is built on
- [How money works](skills/billing/iblai-vibe-pricing/SKILL.md) · [Ship anywhere](docs/ship.md) · [The two MCP servers](docs/mcp-servers.md)
- [Contributing a skill](CONTRIBUTING.md) — including where it goes and how to catalogue it

Vibe is designed to be built with AI. The [@iblai/mcp](https://www.npmjs.com/package/@iblai/mcp) server gives Claude Code deep knowledge of the ibl.ai platform, and the bundled skills guide you through every common task.

### MCP Server

Add this to your `.mcp.json` at the project root:

```json
{
  "mcpServers": {
    "iblai": {
      "command": "npx",
      "args": ["-y", "@iblai/mcp"]
    }
  }
}

This gives your AI assistant access to:

get_component_info("ChatWidget")              # Props, usage, examples for any component
get_hook_info("useAdvancedChat")              # Hook parameters and return types
get_api_query_info("useGetUserMetadataQuery") # RTK Query endpoint details
get_provider_setup("auth")                    # Provider hierarchy and setup code
create_page_template("Dashboard", "mentor")   # Generate a page following ibl.ai patterns

Claude Code Skills

The scaffolded app ships with skills that teach Claude how to work with your codebase. Instead of reading docs, you tell Claude what you want and the skills provide the context:

Skills are in skills/ (symlinked to .claude/skills/). Read them, extend them, or write your own.

Platform Capabilities

iOS & Android SSO limitation: Mobile WebViews use a non-standard user-agent that SSO providers reject. Completing the OAuth flow requires a system browser popup (ASWebAuthenticationSession on iOS, Chrome Custom Tabs on Android). This is not yet implemented -- mobile users must authenticate via another method for now.

Deploy Anywhere

Vercel (recommended)

One-click deploy. Connect your repo, set your environment variables, and push. Or deploy with the vercel CLI -- see /iblai-vibe-ops-deploy:

npx vercel deploy --prod --token="$VERCEL_TOKEN" --yes --public

Tauri (Desktop & Mobile)

Build native apps for macOS, Windows, Linux, iOS, and Android:

Add the Tauri shell (see /iblai-vibe-ops-build), then:

pnpm exec tauri build           # Desktop build for current platform
pnpm exec tauri ios init        # iOS project setup

Resources

Built with iblai/vibe

Agentic OS (iblai/os) · Agentic LMS (iblai/lms) · vibe-agent (one creator, one agent, one paywall) · marketing skills in iblai/vibe-marketing

License

MIT — ibl.ai