kognitos

Kognitos Plugin

Structured Kognitos development skills — bootstrap, app development, SOP design, API integration, debugging, and deployment — packaged for Claude Code, Codex CLI, and Cursor.

The canonical content is the skill set under skills/. Each skill is a self-contained playbook with a default SKILL.md workflow and progressive-disclosure references, scripts, and assets.

What you get

Six skills, installable as a single plugin:

Skill	Use when you need to…
kognitos-bootstrap	Set up a Kognitos workspace, verify prerequisites, discover org/workspace IDs from a PAT.
kognitos-app-development	Build a Kognitos-backed app with clear architecture and Lattice UI patterns.
kognitos-sop-development	Design and refine Kognitos SOPs with traceable decision points.
kognitos-api-client	Integrate Kognitos APIs through explicit adapters and stable request contracts.
kognitos-debugging	Isolate failure boundaries and capture evidence for a Kognitos bug.
kognitos-deployment	Promote changes across environments with explicit release checks.

Install

The plugin supports three surfaces. Pick the one that matches your editor or CLI.

Claude Code

/plugin marketplace add https://github.com/kognitos/kognitos-plugin
/plugin install kognitos

After install, skills auto-invoke when your prompt matches one of the descriptions above. To verify the install end-to-end, ask Claude Code to run the bootstrap skill:

run the kognitos bootstrap skill

It will walk through the credential check and, if your PAT is set, confirm API connectivity.

Codex CLI

This repo includes both the plugin manifest at .codex-plugin/plugin.json and a repo-local marketplace entry at .agents/plugins/marketplace.json, which points Codex at the repo root (./) for local distribution.

git clone https://github.com/kognitos/kognitos-plugin.git
cd kognitos-plugin
codex

Then in the Codex CLI:

1. Run /plugins
2. Open the Local Kognitos Plugins marketplace
3. Select Kognitos Plugin
4. Choose Install plugin

After install, start a new thread and ask Codex to use a Kognitos skill directly or describe the task in natural language. Skills load from the ./skills/ path declared in the manifest and can also be invoked explicitly with @Kognitos Plugin or by naming the skill.

If the plugin does not appear immediately, restart Codex from the repo root and reopen /plugins.

See the Codex plugins overview, build plugins guide, and skills docs for the current Codex plugin and skill conventions.

Cursor

Cursor 2.5+ supports plugins. This repo ships .cursor-plugin/plugin.json, a rules/ directory with the Kognitos project rule, and the shared skills/ playbooks — Cursor auto-discovers all three.

Install from the Cursor Marketplace (search for kognitos), or via the in-editor UI:

1. Open the Cursor plugin marketplace panel
2. Install the kognitos plugin
3. Restart Cursor if prompted

Once installed, Cursor's agent automatically attaches rules/kognitos.mdc (alwaysApply: true) to every chat and loads the matching skills/*/SKILL.md when a task maps to one of the skills.

Manual install (for pre-2.5 Cursor, local development, or offline use): clone this repo into ~/.cursor/plugins/kognitos/, then restart Cursor. Alternatively, copy rules/kognitos.mdc into your project's .cursor/rules/ directory and the skills/ directory into your project.

Enterprise note: Cursor 3.0 defaults third-party plugin imports to off for Enterprise tenants. Your Cursor admin may need to allow this plugin explicitly.

First run

After install, set up credentials once.

1. Get a Kognitos PAT

Generate a Personal Access Token from the Kognitos console. Tokens are prefixed kgn_pat_.

2. Create .env.local

In the root of the project where you'll use the plugin:

KOGNITOS_TOKEN=kgn_pat_<your-token>
KOGNITOS_BASE_URL=https://app.us-1.kognitos.com
KOGNITOS_ORGANIZATION_ID=<your-org-id>
KOGNITOS_WORKSPACE_ID=<your-workspace-id>

If you don't know your org or workspace IDs yet, leave them blank. Set KOGNITOS_TOKEN and KOGNITOS_BASE_URL, then run kognitos-bootstrap — it discovers the IDs from your token.

3. API base URL

KOGNITOS_BASE_URL is https://app.us-1.kognitos.com for US customers. EU customers swap us-1 for eu-1.

Repository layout