cortex-plugin-dev

Native development plugin for Cortex

中文

---

The official development plugin for Cortex. Extends the Repertoire layer with native coding tools, version control integration, infrastructure management, and guided workflow skills — all built on cortex-sdk with zero dependency on Cortex internals.

Install

cortex plugin install by-scott/cortex-plugin-dev
cortex restart

Tools

File Search & Code Analysis

Tool	Description
glob	Find files by pattern (.gitignore-aware, sorted by modification time)
grep	Search file contents with regex (context lines, match counts)
symbols	Extract code symbols via tree-sitter (Rust, Python, TypeScript, TSX)
imports	Extract import/dependency relationships
diff	Compare two files (unified diff, independent of git)

Version Control

Tool	Description
git_status	Working tree status
git_diff	Changes between working tree, staging, or references
git_log	Commit history
git_commit	Stage files and create commit
worktree_create	Create isolated git worktree with new branch
worktree_remove	Remove worktree and branch
worktree_list	List active worktrees

Task Management & Planning

Tool	Description
task_create	Create structured task with dependency tracking
task_list	List tasks with status and blockers
task_update	Update task status, metadata, dependencies
enter_plan_mode	Signal exploration/design phase
exit_plan_mode	Complete planning, ready for review
todo	Freeform session-scoped notes

Infrastructure & System

Tool	Description
diagnostics	Language diagnostics (cargo check, clippy, pyright, mypy, tsc, go vet, eslint)
lsp	Language server operations via CLI (definition, references, hover)
repl	Execute Python or Node.js code
sql	Query SQLite databases (read-only by default)
http	HTTP requests (GET, POST, PUT, DELETE, PATCH, HEAD)
docker	Docker operations (ps, images, run, exec, logs, build, compose)
ps	Process listing and port inspection
notebook_edit	Jupyter notebook cell editing
env	Environment variables and system info

Communication & Coordination

Tool	Description
ask_user	Structured prompts with options
send_message	Message to user or agent
brief	Conversation and task summarization
team_create	Create agent team for parallel work
team_delete	Remove team

Skills

Skill	Trigger	Purpose
commit	commit, 提交	Review changes, draft message, stage, commit
review-pr	review PR, 代码审查	Structured code review with severity-rated findings
simplify	simplify, refactor, 简化	Detect and remove unnecessary complexity
test	run test, 测试	Discover, run, analyze failures, fix
create-pr	create PR, 提交 PR	Draft PR with summary and test plan
explore	explore, 项目结构	Map structure, entry points, conventions
debug	debug, 排查	Reproduce, isolate, trace, root-cause, fix

Runtime Integration

Tools access Cortex runtime via cortex-sdk:

• Session awareness — session ID, canonical actor, source transport, execution scope
• Progress emission — step-by-step updates for long operations
• Observer text — diagnostic information to the parent turn's observer lane
• Namespaced state — task, team, and note state isolated per actor/session
• Background safety — diagnostics, process, REPL, Docker tools declare background_safe

Tree-sitter Engine

Language	Extensions	Symbol Types
Rust	.rs	functions, methods, structs, enums, constants, type aliases, modules, imports
Python	.py	functions, classes, imports
TypeScript	.ts, .tsx	functions, classes, interfaces, enums, type aliases, imports

Build & Package

cargo build --release
cortex plugin pack . ./cortex-plugin-dev.cpx

The packer auto-resolves the native library from target/release/ based on manifest.toml.

License

MIT