Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:42:08 +08:00
commit 48bcd0f33f
5 changed files with 140 additions and 0 deletions

View File

@@ -0,0 +1,15 @@
{
"name": "kit",
"description": "Kit plugin for Claude Code",
"version": "1.0.0",
"author": {
"name": "Nathan Vale",
"email": "hi@nathanvale.com"
},
"commands": [
"./commands"
],
"hooks": [
"./hooks"
]
}

3
README.md Normal file
View File

@@ -0,0 +1,3 @@
# kit
Kit plugin for Claude Code

69
commands/logs.md Normal file
View File

@@ -0,0 +1,69 @@
---
description: View Kit plugin logs for debugging
argument-hint: [lines?] [correlation-id?]
---
# Kit Logs Command
View and filter JSONL logs from the Kit MCP server.
## Instructions
1. Log file location: `~/.kit/logs/kit.jsonl`
2. Default: Show last 20 log entries
3. With `lines` argument: Show last N entries
4. With `correlation-id`: Filter by specific operation
## Usage Examples
### View recent logs
```
/kit:logs
```
Shows the last 20 log entries formatted for readability.
### View more logs
```
/kit:logs 50
```
Shows the last 50 log entries.
### Filter by correlation ID
```
/kit:logs a1b2c3d4
```
Shows all log entries for a specific operation (useful for tracing failures).
## Log Format
Each log entry contains:
- `@timestamp` - When the event occurred
- `@category` - Log category (kit, kit.grep, kit.semantic, kit.symbols)
- `@level` - Log level (debug, info, warn, error)
- `@message` - Human-readable message
- `cid` - Correlation ID for tracing operations
- Additional context fields (query, pattern, matchCount, durationMs, etc.)
## Implementation
Read the log file and format entries:
```bash
# Default: last 20 lines
tail -20 ~/.kit/logs/kit.jsonl | jq '.'
# Filter by correlation ID
jq 'select(.cid == "CORRELATION_ID")' ~/.kit/logs/kit.jsonl
# Show only errors
jq 'select(.["@level"] == "error")' ~/.kit/logs/kit.jsonl
```
Present logs in a readable table or formatted list showing:
- Timestamp
- Level (with appropriate indicator)
- Category
- Message
- Key context (cid, matchCount, durationMs if present)
If the log file doesn't exist, inform the user that no logs have been generated yet.

4
hooks/hooks.json Normal file
View File

@@ -0,0 +1,4 @@
{
"description": "Hooks for kit plugin",
"hooks": {}
}

49
plugin.lock.json Normal file
View File

@@ -0,0 +1,49 @@
{
"$schema": "internal://schemas/plugin.lock.v1.json",
"pluginId": "gh:nathanvale/side-quest-marketplace:plugins/kit",
"normalized": {
"repo": null,
"ref": "refs/tags/v20251128.0",
"commit": "9f8f1984bc29bd7ac5d1a1fde6d355742996b776",
"treeHash": "701bfdb3e01cc47b3bdb67e7a578b9a0c688ab977bdfffac2633ae69d8880f71",
"generatedAt": "2025-11-28T10:27:16.539153Z",
"toolVersion": "publish_plugins.py@0.2.0"
},
"origin": {
"remote": "git@github.com:zhongweili/42plugin-data.git",
"branch": "master",
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
},
"manifest": {
"name": "kit",
"description": "Kit plugin for Claude Code",
"version": "1.0.0"
},
"content": {
"files": [
{
"path": "README.md",
"sha256": "6a50b3050702d8b228696f6a954da0a1cde65088f9283307cccaad3417c0ae4b"
},
{
"path": "hooks/hooks.json",
"sha256": "004827cc955d2c6660360a9ff2df829faeca27ec84cb0e449c0bfb9514e541f9"
},
{
"path": ".claude-plugin/plugin.json",
"sha256": "8293b53e6e1f5a0bee165cc97cb70643a099d090aa6ce97e65bccd988c0db429"
},
{
"path": "commands/logs.md",
"sha256": "6a3830644920c7f61fc6c3775bd9d46495d35a7027a2fe7713eb5cc68f7c1a3d"
}
],
"dirSha256": "701bfdb3e01cc47b3bdb67e7a578b9a0c688ab977bdfffac2633ae69d8880f71"
},
"security": {
"scannedAt": null,
"scannerVersion": null,
"flags": []
}
}