unifai 2.0.2 → 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,15 +1,15 @@
1
1
  # unifai
2
2
 
3
- > Universal AI IDE Configuration & Skill Manager
3
+ > Universal AI IDE Configuration & Sync Tool
4
4
 
5
- A powerful CLI tool to unify your AI coding agent experience. Standardize instructions, manage MCP servers, and install agent skills across Claude Code, Antigravity, Cursor, OpenCode, and GitHub Copilot.
5
+ A powerful CLI tool to unify your AI coding agent experience. Standardize instructions, manage MCP servers, skills, and synchronize rules across Claude Code, Antigravity, Cursor, OpenCode, and GitHub Copilot.
6
6
 
7
7
  ## 🚀 Key Features
8
8
 
9
9
  - 🔄 **Universal Sync & Migration** - Synchronize and migrate agent instructions, rules, and MCP configs across all IDEs at once.
10
10
  - đŸ› ī¸ **MCP Management** - Add, list, and sync Model Context Protocol servers (Standard Stdio & HTTP/SSE).
11
+ - 📁 **Skills Management** - Manage skills centrally (e.g., `~/.gemini/skills`) or per project (e.g., `.agent/skills`).
11
12
  - 🤖 **Standardized Agents** - Project-level `AGENTS.md` and `CLAUDE.md` with professional prompt templates.
12
- - ✨ **Skill Manager** - Install specialized agent instructions from any Git repository.
13
13
  - 📐 **Cross-IDE Scavenging** - Automatically discover rules from `.claude/`, `.cursor/`, or `.agent/` and unify them.
14
14
  - 🌐 **Global & Workspace Rules** - Manage rules centrally (e.g., `~/.gemini/GEMINI.md`) or per project.
15
15
 
@@ -50,13 +50,6 @@ Initialize a standardized instruction set for your project with built-in best pr
50
50
  unifai agent init
51
51
  ```
52
52
 
53
- ### 4. Install Agent Skills
54
- Install specialized behaviors (like "frontend-expert" or "testing-pro") from any Git repo:
55
- ```bash
56
- # Install skills from a GitHub repository
57
- unifai includeHasan/agent-skills
58
- ```
59
-
60
53
  ## 🔄 Universal Migration Paths
61
54
 
62
55
  The `sync` command "scavenges" configurations from these locations and migrates them to your active IDEs:
@@ -66,16 +59,17 @@ The `sync` command "scavenges" configurations from these locations and migrates
66
59
  | **Instructions** | `AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md` |
67
60
  | **Rules** | `.agent/rules/`, `.claude/rules/`, `.cursor/rules/`, `.gemini/rules/`, `.cursorrules` |
68
61
  | **MCP** | `.mcp/mcp.json`, `.claude/mcp.json`, `.cursor/mcp.json` |
62
+ | **Skills** | `skills/`, `.agent/skills/`, `.claude/skills/`, `.cursor/skills/`, `.github/skills/` |
69
63
 
70
64
  ## 🤖 Supported Adapters
71
65
 
72
- | Adapter | Workspace File | Global File | MCP Config |
73
- |---------|----------------|-------------|------------|
74
- | **Antigravity** | `AGENTS.md` | `~/.gemini/GEMINI.md` | `.gemini/settings.json` |
75
- | **Claude Code** | `CLAUDE.md` | `~/.claude.md` | `.claude/mcp.json` |
76
- | **OpenCode** | `AGENTS.md` | `~/.opencode.md` | `mcp.json` |
77
- | **Cursor** | `AGENTS.md` | `~/.cursorrules` | `.cursor/mcp.json` |
78
- | **GitHub Copilot** | `.github/copilot-instructions.md` | - | - |
66
+ | Adapter | Workspace File | Global File | MCP Config | Skills |
67
+ |---------|----------------|-------------|------------|--------|
68
+ | **Antigravity** | `AGENTS.md` | `~/.gemini/GEMINI.md` | `.gemini/settings.json` | `.agent/skills` |
69
+ | **Claude Code** | `CLAUDE.md` | `~/.claude.md` | `.claude/mcp.json` | `.claude/skills` |
70
+ | **OpenCode** | `AGENTS.md` | `~/.opencode.md` | `mcp.json` | `.opencode/skill` |
71
+ | **Cursor** | `AGENTS.md` | `~/.cursorrules` | `.cursor/mcp.json` | `.cursor/skills` |
72
+ | **GitHub Copilot** | `.github/copilot-instructions.md` | - | - | `.github/skills` |
79
73
 
80
74
  ## đŸ•šī¸ Command Reference
81
75
 
@@ -86,14 +80,12 @@ The `sync` command "scavenges" configurations from these locations and migrates
86
80
  | `mcp sync` | Sync MCP servers to all assistant configs |
87
81
  | `agent init` | Initialize standardized agent instruction files |
88
82
  | `agent show` | Show current agent configuration |
89
- | `<git-url>` | Install skills from a remote repository |
90
83
 
91
84
  ## đŸ—ī¸ Folder Structure
92
85
 
93
86
  Universal AI IDEs follow these conventions through `unifai`:
94
87
 
95
88
  - **Workspace Rules**: `.agent/rules/` (Unified Markdown files)
96
- - **Agent Skills**: `.agent/skills/`
97
89
  - **Global Config**: `~/.gemini/` (Settings, global rules, and instructions)
98
90
 
99
91
  ## 📄 License
@@ -5,7 +5,7 @@
5
5
  * consistent configuration generation across different AI coding assistants.
6
6
  */
7
7
  import type { AgentConfig, MCPServer, RuleSet, SyncResult, IDEConfig } from '../types/config.js';
8
- import type { AgentType } from '../types/index.js';
8
+ import type { AgentType, Skill } from '../types/index.js';
9
9
  /**
10
10
  * Abstract base class for IDE adapters
11
11
  */
@@ -42,11 +42,16 @@ export declare abstract class BaseAdapter {
42
42
  * Get the path where MCP config should be written
43
43
  */
44
44
  abstract getMCPConfigPath(projectPath: string, global?: boolean): string;
45
+ /**
46
+ * Get the path where skills should be written
47
+ */
48
+ getSkillsPath(projectPath: string, global?: boolean): string;
45
49
  /**
46
50
  * Sync all configurations to this IDE
47
51
  */
48
52
  sync(projectPath: string, config: AgentConfig, rules?: RuleSet, options?: {
49
53
  global?: boolean;
54
+ skills?: Skill[];
50
55
  }): Promise<SyncResult>;
51
56
  /**
52
57
  * Helper to write file and track result
@@ -1 +1 @@
1
- {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,8BAAsB,WAAW;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtF;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAExE;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAEpE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAExE;;OAEG;IACG,IAAI,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,UAAU,CAAC;IA8CtB;;OAEG;cACa,SAAS,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC;CA6BnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC"}
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1D;;GAEG;AACH,8BAAsB,WAAW;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtF;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAExE;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAEpE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAExE;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM;IAO5D;;OAEG;IACG,IAAI,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;KAAE,GACjD,OAAO,CAAC,UAAU,CAAC;IA8DtB;;OAEG;cACa,SAAS,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC;CA6BnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC"}