Cursor
Semantica captures Cursor session data automatically during semantica enable.
How it works
Semantica installs a hook in .cursor/hooks.json that fires at the end of Cursor composer sessions. It reads from Cursor's local storage databases, the legacy .vscdb format, the modern ai-code-tracking.db, and agent transcript JSONL files, to extract which files were modified during the session.
Semantica reads these databases passively and never modifies them.
Attribution quality
Cursor provides file-level modified attribution: Semantica can identify which files were touched by the AI agent in a session, and marks lines in those files as AI-attributed. Because Cursor does not expose exact AI-generated content the way Claude Code does, attribution is at the file level rather than individual lines.
Setup
Cursor is detected and configured automatically during semantica enable. To reinstall:
semantica enable --providers cursor
Hook configuration location
.cursor/hooks.json
MCP integration
semantica mcp enable
Adds Semantica's MCP server to .cursor/mcp.json. Cursor will discover semantica_search, semantica_playbook_use, and semantica_explain automatically.
Gemini CLI
Semantica captures Gemini CLI sessions automatically.
How it works
Semantica adds an entry to ~/.gemini/settings.json (the global Gemini CLI config) that fires hooks at session checkpoints. Session data is read from ~/.gemini/tmp/<project-hash>/chats/.
The hook config is installed globally rather than per-repo, so Gemini CLI sessions are captured in any repo where Semantica is enabled.
Attribution quality
Gemini CLI provides file-level attribution: Semantica captures which files were modified during a session and attributes those changes accordingly.
Setup
Gemini CLI is detected and configured automatically during semantica enable. To reinstall:
semantica enable --providers gemini-cli
Hook configuration location
~/.gemini/settings.json
MCP integration
semantica mcp enable
Adds Semantica's MCP server to ~/.gemini/settings.json.
GitHub Copilot CLI
Semantica captures GitHub Copilot CLI sessions automatically.
How it works
Semantica installs a hook in .github/hooks/semantica.json (repo-local). This hook fires at Copilot agent session boundaries and reports which files were modified.
Attribution quality
Copilot CLI provides file-level modified attribution.
Setup
Copilot CLI is detected and configured automatically during semantica enable. To reinstall:
semantica enable --providers copilot-cli
Hook configuration location
.github/hooks/semantica.json
MCP integration
semantica mcp enable
Adds Semantica's MCP server to .copilot/mcp-config.json.
Kiro IDE
Semantica supports Kiro IDE, providing repo-local capture with execution trace data.
How it works
Semantica installs a hook in .kiro/hooks/ as a .kiro.hook file. Kiro IDE fires this hook at session lifecycle events. Semantica parses Kiro's execution trace format, which includes per-action timestamps and file-level modification data.
Attribution quality
Kiro IDE provides file-level modified attribution via execution trace parsing. The execution trace includes per-action timestamps, which allows Semantica to precisely correlate agent actions with commits by time window.
Future versions may support line-level attribution using modifiedContent fields present in the trace format.
Setup
Kiro IDE is detected and configured automatically during semantica enable. To install explicitly:
semantica enable --providers kiro-ide
Hook configuration location
.kiro/hooks/semantica.kiro.hook
MCP integration
semantica mcp enable
Adds Semantica's MCP server to .kiro/settings/mcp.json.
Kiro CLI
Semantica supports Kiro CLI using a named agent configuration approach.
How it works
Semantica installs a named agent config at .kiro/agents/semantica.json. When a Kiro CLI session runs with the semantica agent config active, Semantica capture and MCP tools are enabled for that session.
Kiro CLI's agent configuration includes PostToolUse hooks that fire after each tool call, providing rich per-tool-call data including file content from fs_write calls.
Attribution quality
Kiro CLI provides the richest raw data of any provider. The PostToolUse hook gives Semantica access to exact file content from every write operation, making line-level attribution possible in a future version. Currently, Semantica uses file-level modified attribution.
Setup
Kiro CLI is detected and configured automatically during semantica enable. To install explicitly:
semantica enable --providers kiro-cli
Activating the Semantica agent config
To capture a session, the Kiro CLI must be running with the semantica agent config:
kiro-cli chat --agent semantica
To make it the repo default (so all sessions in this repo use it automatically):
kiro-cli agent set-default semantica
Hook configuration location
.kiro/agents/semantica.json
MCP integration
MCP tools are included in the semantica agent config and are active whenever the agent is selected. No separate semantica mcp enable step is needed for Kiro CLI.