Keep the conventions you already use.
Knotic reads Skills, custom agents, hooks and MCP configuration from your repositories. Add .knotic/ alongside the conventions your team already keeps.
Working with Skills, Agents, Hooks & MCP
Add a Skill
Put a SKILL.md folder in .agents/skills, .github/skills, .claude/skills or .knotic/skills. The sidebar reports status and conflicts.
Define a specialist
Use New Project Agent or add .github/agents/<name>.agent.md. Select agents from / or let a Session delegate.
Configure hooks
Add command hooks for prompt submission, before or after tool use, and agent stop. Review their last execution output in the Hooks editor.
Connect MCP servers
Use .knotic/mcp.json, .vscode/mcp.json or .mcp.json. Start, stop and authenticate servers in the sidebar; select tools, prompts and resources from /.
Skills, Agents, Hooks & MCP: the details
Open the details that matter to your workflow.
Skills
Project Skills use SKILL.md folders. Global locations include ~/.agents/skills, ~/.copilot/skills and ~/.claude/skills. Agents load Skills on demand.
Custom agents
Agent frontmatter defines name, description, tools, Skills, MCP servers and invocation flags. Delegation keeps the parent’s model and permission ceiling.
Hooks
Sources include .knotic/hooks/*.json, .github/hooks/*.json, .claude/settings.json, .claude/settings.local.json, .codex/hooks.json and .codex/config.toml. Before-hooks fail closed.
MCP servers
Stdio and Streamable HTTP, OAuth and elicitation are supported. The sidebar also lists global, remote, extension and plugin servers.
Commit messages
The sparkle in Source Control sends the staged diff, or working tree fallback, to Knotic’s utility model. It drafts an English Conventional Commits message and never commits for you.
Knotic CLI
Terminal Sessions share the local archive with the desktop and support Skills, MCP and hooks. API providers only; Node.js 24.18 or newer. CLI distribution is not yet available on npm.
Know the boundaries
- Hook scripts from another tool may need adapting because tool names differ.
- The CLI does not include Architect, Brainstorming, Context Lens UI, Duckie or subscription providers.
- Read-only web research opens pages but does not submit forms or run page scripts.