Skip to content

Commit b5242b2

Browse files
committed
chore: 0.5.0 — conversation explorer, streamlined README
- Conversation Explorer by @victorgalvez56 (async, streaming, secure) - README rewritten: concise install + feature overview - Version bump to 0.5.0
1 parent 2a5a5cb commit b5242b2

3 files changed

Lines changed: 32 additions & 85 deletions

File tree

README.md

Lines changed: 30 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,39 @@
11
# Agentfiles
22

3-
Discover, organize, and edit AI agent skills, commands, and agents across Claude Code, Cursor, Codex, Windsurf, and more — from inside Obsidian.
3+
AI skills manager for Obsidian. Browse, create, and manage skills across Claude Code, Cursor, Codex, Windsurf, and 10+ coding agents.
44

55
![Browse skills, commands, and agents across 13+ coding assistants](assets/browse.jpeg)
66

77
![Dashboard with burn rate, context tax, and health metrics](assets/dashboard.jpeg)
88

9-
## Features
10-
11-
### Skill browser
12-
- Multi-tool discovery across 13+ coding agents
13-
- Three-column layout: sidebar filters, skill list, detail panel
14-
- Search by skill name with instant filtering
15-
- Filter by status: stale, heavy, oversized, conflict
16-
- Sort by name or usage count
17-
- Symlink-aware scanning (follows symlinked skill directories)
18-
- Project-level skill scanning (auto-detects vault's `.claude/skills/`)
19-
- Name-based deduplication across tools
20-
21-
### Detail panel
22-
- Markdown preview with syntax-highlighted code blocks
23-
- Built-in editor with Cmd+S save
24-
- Frontmatter metadata display
25-
- File path, size, character count, token estimation
26-
- Warnings: oversized skills (>500 lines), long descriptions (>1024 chars)
27-
- Usage sparkline (30-day daily trend)
28-
- Conflict detection with similarity scores
29-
- Execution traces (last 5 with model, tokens, cost, duration)
30-
- Remove skill button with confirmation dialog
31-
32-
### Marketplace
33-
- Browse and search skills from [skills.sh](https://skills.sh) registry
34-
- Popular skills on first load (cached across sessions)
35-
- Skill content preview with markdown rendering
36-
- Install modal with agent selection (17 agents), scope toggle (project/global), and SVG logos
37-
- Uninstall with lock file and copy cleanup
38-
- Persistent install preferences across sessions
39-
- Configurable package runner (auto/npx/bunx)
40-
41-
### Dashboard (requires [skillkit](https://www.npmjs.com/package/@crafter/skillkit))
42-
- Overview: invocations, active skills, installed count, stale count
43-
- Streaks: current and longest streak with "on fire" badge
44-
- Weekly velocity: cost comparison vs last week with change percentage
45-
- Top skills: bar chart of most-used skills (30 days)
46-
- Health: donut chart of active vs unused, metadata budget bar
47-
- Burn rate: daily cost chart, model breakdown, session and API call counts
48-
- Context tax: stacked bar (CLAUDE.md + skills metadata + memory), per-session cost, cache savings
49-
- Stale skills list
50-
- Action buttons: update skills, scan sessions, prune stale (with confirmation)
51-
- Disk-cached data for instant load on Obsidian restart
52-
- Manual refresh only (no blocking auto-refresh)
53-
54-
### Badges on skill cards
55-
- Use count (blue)
56-
- **STALE** (red) — not triggered in 30+ days
57-
- **HEAVY** (yellow) — content exceeds 5k characters
58-
- **OVERSIZED** (orange) — more than 500 lines
59-
- **CONFLICT** (red) — overlaps with other skills
60-
61-
### Tool logos
62-
Real SVG logos for: Claude Code, Cursor, Windsurf, Codex, GitHub Copilot, OpenCode, Goose, Cline, Continue, Roo Code, Replit, Gemini CLI. Striped placeholder for agents without logos.
9+
## Install
10+
11+
### From Obsidian (coming soon)
12+
13+
Search **Agentfiles** in Settings > Community plugins.
14+
15+
### Manual
16+
17+
```bash
18+
# Option A: Download from GitHub
19+
# 1. Get main.js, manifest.json, styles.css from the latest release
20+
# 2. Copy to <vault>/.obsidian/plugins/agentfiles/
21+
# 3. Enable in Settings > Community plugins
22+
23+
# Option B: Using skillkit
24+
npm i -g @crafter/skillkit
25+
skillkit scan
26+
```
27+
28+
## What it does
29+
30+
- **Browse** skills, commands, and agents from 13+ tools in one place
31+
- **Search** by name or file content with deep search toggle
32+
- **Create** new skills with a stepped wizard (pick tool, type, name)
33+
- **Edit** skills inline with markdown preview and Cmd+S save
34+
- **Marketplace** — install skills from [skills.sh](https://skills.sh)
35+
- **Conversations** — browse Claude Code session history, search, tag, and export to vault
36+
- **Dashboard** — usage analytics, burn rate, context tax, health metrics (requires [skillkit](https://www.npmjs.com/package/@crafter/skillkit))
6337

6438
## Supported tools
6539

@@ -74,34 +48,7 @@ Real SVG logos for: Claude Code, Cursor, Windsurf, Codex, GitHub Copilot, OpenCo
7448
| OpenCode | `~/.config/opencode/skills/` | | |
7549
| Global | `~/.agents/skills/` | | |
7650

77-
## Installation
78-
79-
Search **Agentfiles** in Obsidian's Community plugins browser, or install manually:
80-
81-
1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/Railly/agentfiles/releases)
82-
2. Create `.obsidian/plugins/agentfiles/` in your vault
83-
3. Copy the three files into that folder
84-
4. Enable the plugin in Settings > Community plugins
85-
86-
## Usage
87-
88-
1. Click the CPU icon in the ribbon, or run **Agentfiles: Open** from the command palette
89-
2. Browse skills by tool, type, or project in the sidebar
90-
3. Click any skill to preview its content and metadata
91-
4. Click the pencil icon to edit, Cmd+S to save
92-
5. Click **Dashboard** for analytics (requires skillkit)
93-
6. Click **Marketplace** to browse and install skills from skills.sh
94-
95-
## Settings
96-
97-
- **File watching** — auto-detect changes to skill files
98-
- **Project scanning** — scan directories for project-level skills
99-
- **Package runner** — choose between auto-detect, npx, or bunx for marketplace installs
100-
- **Tool toggles** — enable/disable individual coding agents
101-
102-
## Desktop only
103-
104-
This plugin requires desktop Obsidian (macOS, Windows, Linux) because it reads files outside your vault.
51+
Desktop only (macOS, Windows, Linux) — reads files outside your vault.
10552

10653
## License
10754

manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"id": "agentfiles",
33
"name": "Agentfiles",
4-
"version": "0.4.4",
4+
"version": "0.5.0",
55
"minAppVersion": "1.4.11",
66
"description": "Discover, organize, and edit AI agent skills, commands, and agents across Claude Code, Cursor, Codex, Windsurf, and more.",
77
"author": "Railly Hugo",

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "agentfiles",
3-
"version": "0.4.4",
3+
"version": "0.5.0",
44
"description": "AI Skills Manager for Obsidian",
55
"main": "main.js",
66
"scripts": {

0 commit comments

Comments
 (0)