@tjdals12/agent-bolt 1.2.0 → 1.3.0-next.2

package/README.ko.md

@@ -200,12 +200,14 @@ $ agent-bolt add-pack --source=common --packs=common
 $ agent-bolt add-item --source=common --pack=backend --skills=nestjs-expert
 
 ▌ Agent Bolt: Added 1 item to common/backend
-  (created pack backend in common)
+  (added new pack 'backend' in source 'common')
 
   + 🔧 nestjs-expert
 ...
 ```
 
+아이템 옵션을 빼면 아이템을 목록에서 골라 추가합니다. `--pack`까지 빼면 팩을 먼저 고르고, `--source`까지 빼면 완전 대화형으로 동작해 소스와 팩을 오가며 계속 추가할 수 있습니다.
+
 `remove-pack`·`remove-item`으로 추가한 패키지·아이템을 삭제합니다.
 
 ```text
@@ -217,6 +219,8 @@ $ agent-bolt remove-item --source=common --pack=common --skills=pr-review
 ...
 ```
 
+아이템 옵션을 빼면 아이템을 목록에서 골라 제거합니다. `--pack`까지 빼면 팩을 먼저 고르고, `--source`까지 빼면 완전 대화형으로 동작해 소스와 팩을 오가며 계속 제거할 수 있습니다.
+
 이 명령들은 설정 파일을 바꿀 뿐입니다. 실제 설치는 `sync`에서 이루어집니다.
 
 ### 에이전트에 설치하기
@@ -563,16 +567,18 @@ agent-bolt add-pack [--source <alias>] [--packs <list>]
 특정 아이템만 설정에 추가합니다. 패키지 항목이 없으면 만들어 둡니다.
 
 ```text
-agent-bolt add-item --source <alias> --pack <name> [options]
+agent-bolt add-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| 옵션                  | 설명                                   | 필수/선택 | 기본값 |
-| --------------------- | -------------------------------------- | --------- | ------ |
-| `--source <alias>`    | 대상 카탈로그                          | 필수      | —      |
-| `--pack <name>`       | 대상 패키지                            | 필수      | —      |
-| `--skills <list>`     | 추가할 스킬 이름. 콤마로 구분          | 선택      | —      |
-| `--agents <list>`     | 추가할 서브 에이전트 이름. 콤마로 구분 | 선택      | —      |
-| `--guidelines <list>` | 추가할 가이드라인 이름. 콤마로 구분    | 선택      | —      |
+| 옵션                  | 설명                                   | 필수/선택 | 기본값      |
+| --------------------- | -------------------------------------- | --------- | ----------- |
+| `--source <alias>`    | 대상 카탈로그                          | 선택      | 대화형 선택 |
+| `--pack <name>`       | 대상 패키지                            | 선택      | 대화형 선택 |
+| `--skills <list>`     | 추가할 스킬 이름. 콤마로 구분          | 선택      | —           |
+| `--agents <list>`     | 추가할 서브 에이전트 이름. 콤마로 구분 | 선택      | —           |
+| `--guidelines <list>` | 추가할 가이드라인 이름. 콤마로 구분    | 선택      | —           |
+
+아이템 옵션을 생략하면 아이템을 대화형으로 고르고, `--pack`까지 생략하면 팩을 먼저 고르며, `--source`까지 생략하면 여러 source를 오가며 반복합니다. `--pack`은 `--source`와, 아이템 옵션은 `--pack`과 함께 써야 합니다.
 
 ### `agent-bolt remove-pack`
 
@@ -594,16 +600,18 @@ agent-bolt remove-pack [--source <alias>] [--packs <list>]
 설정에서 특정 아이템을 제거합니다.
 
 ```text
-agent-bolt remove-item --source <alias> --pack <name> [options]
+agent-bolt remove-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| 옵션                  | 설명                                   | 필수/선택 | 기본값 |
-| --------------------- | -------------------------------------- | --------- | ------ |
-| `--source <alias>`    | 대상 카탈로그                          | 필수      | —      |
-| `--pack <name>`       | 대상 패키지                            | 필수      | —      |
-| `--skills <list>`     | 제거할 스킬 이름. 콤마로 구분          | 선택      | —      |
-| `--agents <list>`     | 제거할 서브 에이전트 이름. 콤마로 구분 | 선택      | —      |
-| `--guidelines <list>` | 제거할 가이드라인 이름. 콤마로 구분    | 선택      | —      |
+| 옵션                  | 설명                                   | 필수/선택 | 기본값      |
+| --------------------- | -------------------------------------- | --------- | ----------- |
+| `--source <alias>`    | 대상 카탈로그                          | 선택      | 대화형 선택 |
+| `--pack <name>`       | 대상 패키지                            | 선택      | 대화형 선택 |
+| `--skills <list>`     | 제거할 스킬 이름. 콤마로 구분          | 선택      | —           |
+| `--agents <list>`     | 제거할 서브 에이전트 이름. 콤마로 구분 | 선택      | —           |
+| `--guidelines <list>` | 제거할 가이드라인 이름. 콤마로 구분    | 선택      | —           |
+
+아이템 옵션을 생략하면 아이템을 대화형으로 고르고, `--pack`까지 생략하면 팩을 먼저 고르며, `--source`까지 생략하면 여러 source를 오가며 반복합니다. `--pack`은 `--source`와, 아이템 옵션은 `--pack`과 함께 써야 합니다.
 
 ### `agent-bolt sync`
 

package/README.md

@@ -200,12 +200,14 @@ Use `add-item` to add just specific items from a package.
 $ agent-bolt add-item --source=common --pack=backend --skills=nestjs-expert
 
 ▌ Agent Bolt: Added 1 item to common/backend
-  (created pack backend in common)
+  (added new pack 'backend' in source 'common')
 
   + 🔧 nestjs-expert
 ...
 ```
 
+Omit the item options to pick items from a checklist. Omit `--pack` too and `add-item` picks a pack first; omit `--source` as well and it goes fully interactive, looping over sources and packs until you're done.
+
 Use `remove-pack` and `remove-item` to drop packages or items you've added.
 
 ```text
@@ -217,6 +219,8 @@ $ agent-bolt remove-item --source=common --pack=common --skills=pr-review
 ...
 ```
 
+Omit the item options to pick items from a checklist. Omit `--pack` too and `remove-item` picks a pack first; omit `--source` as well and it goes fully interactive, looping over sources and packs until you're done.
+
 These commands only edit your config file. The actual installation happens with `sync`.
 
 ### Install into your agents
@@ -563,16 +567,18 @@ Omitting `--packs` picks packages interactively; omitting `--source` as well pic
 Adds specific items to your config. Creates the package entry if it doesn't exist yet.
 
 ```text
-agent-bolt add-item --source <alias> --pack <name> [options]
+agent-bolt add-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| Option                | Description                                 | Required | Default |
-| --------------------- | ------------------------------------------- | -------- | ------- |
-| `--source <alias>`    | Target catalog                              | Required | —       |
-| `--pack <name>`       | Target package                              | Required | —       |
-| `--skills <list>`     | Names of skills to add. Comma-separated     | Optional | —       |
-| `--agents <list>`     | Names of subagents to add. Comma-separated  | Optional | —       |
-| `--guidelines <list>` | Names of guidelines to add. Comma-separated | Optional | —       |
+| Option                | Description                                 | Required | Default            |
+| --------------------- | ------------------------------------------- | -------- | ------------------ |
+| `--source <alias>`    | Target catalog                              | Optional | Interactive prompt |
+| `--pack <name>`       | Target package                              | Optional | Interactive prompt |
+| `--skills <list>`     | Names of skills to add. Comma-separated     | Optional | —                  |
+| `--agents <list>`     | Names of subagents to add. Comma-separated  | Optional | —                  |
+| `--guidelines <list>` | Names of guidelines to add. Comma-separated | Optional | —                  |
+
+Omitting the item options picks items interactively; omitting `--pack` too picks a pack first; omitting `--source` as well loops over sources. `--pack` requires `--source`, and the item options require `--pack`.
 
 ### `agent-bolt remove-pack`
 
@@ -594,16 +600,18 @@ Omitting `--packs` picks packages interactively; omitting `--source` as well pic
 Removes specific items from your config.
 
 ```text
-agent-bolt remove-item --source <alias> --pack <name> [options]
+agent-bolt remove-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| Option                | Description                                    | Required | Default |
-| --------------------- | ---------------------------------------------- | -------- | ------- |
-| `--source <alias>`    | Target catalog                                 | Required | —       |
-| `--pack <name>`       | Target package                                 | Required | —       |
-| `--skills <list>`     | Names of skills to remove. Comma-separated     | Optional | —       |
-| `--agents <list>`     | Names of subagents to remove. Comma-separated  | Optional | —       |
-| `--guidelines <list>` | Names of guidelines to remove. Comma-separated | Optional | —       |
+| Option                | Description                                    | Required | Default            |
+| --------------------- | ---------------------------------------------- | -------- | ------------------ |
+| `--source <alias>`    | Target catalog                                 | Optional | Interactive prompt |
+| `--pack <name>`       | Target package                                 | Optional | Interactive prompt |
+| `--skills <list>`     | Names of skills to remove. Comma-separated     | Optional | —                  |
+| `--agents <list>`     | Names of subagents to remove. Comma-separated  | Optional | —                  |
+| `--guidelines <list>` | Names of guidelines to remove. Comma-separated | Optional | —                  |
+
+Omitting the item options picks items interactively; omitting `--pack` too picks a pack first; omitting `--source` as well loops over sources. `--pack` requires `--source`, and the item options require `--pack`.
 
 ### `agent-bolt sync`
 

package/dist/catalog/commands/add-item.d.ts

@@ -1,25 +1,42 @@
 import { type ItemType } from '#catalog/content/item/model.js';
-export type AddItemResult = {
-    sourceAlias: string;
+import type { ProgressReporter } from '#core/progress.js';
+export type AddedItemPack = {
     packName: string;
     packCreated: boolean;
     addedItems: Record<ItemType, string[]>;
     skippedItems: Record<ItemType, string[]>;
 };
+export type AddedItemSourceResult = {
+    sourceAlias: string;
+    packs: AddedItemPack[];
+};
+export type AddItemResult = {
+    results: AddedItemSourceResult[];
+    failures: string[];
+};
 export declare class AddItemCommand {
-    private readonly _source;
-    private readonly _pack;
+    private readonly _source?;
+    private readonly _pack?;
     private readonly _skills?;
     private readonly _agents?;
     private readonly _guidelines?;
     constructor(options: {
-        source: string;
-        pack: string;
+        source?: string;
+        pack?: string;
         skills?: string;
         agents?: string;
         guidelines?: string;
     });
-    execute(projectPath: string): AddItemResult;
+    execute(projectPath: string, reporter: ProgressReporter): Promise<AddItemResult>;
+    private addItemsFromSource;
+    private mergePackInto;
+    private addItemsToPack;
+    private resolveCatalogDetail;
+    private promptSourceSelection;
+    private countConfiguredItems;
+    private promptPackSelection;
+    private promptItemSelection;
+    private countAddedItems;
     private parseItemNames;
 }
 //# sourceMappingURL=add-item.d.ts.map

package/dist/catalog/commands/add-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/add-item.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG3E,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAQD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAwI3C,OAAO,CAAC,cAAc;CAQvB"}
+{"version":3,"file":"add-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/add-item.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,OAAO,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAQK,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;YA0GxE,kBAAkB;IAuFhC,OAAO,CAAC,aAAa;YAcP,cAAc;IA2H5B,OAAO,CAAC,oBAAoB;YAwBd,qBAAqB;IA6BnC,OAAO,CAAC,oBAAoB;YAsBd,mBAAmB;YA8CnB,mBAAmB;IAgFjC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/catalog/commands/add-item.js

@@ -1,9 +1,14 @@
+import { checkbox, select, Separator } from '@inquirer/prompts';
+import chalk from 'chalk';
 import { buildCatalogConfigPath } from '#core/paths.js';
+import { canPrompt } from '#core/tty.js';
 import { loadConfig } from '#catalog/config/load.js';
 import { editConfigFile } from '#catalog/config/write.js';
 import { resolveCatalogDir } from '#catalog/source/resolve.js';
 import { ITEM_TYPES } from '#catalog/content/item/model.js';
 import { parseCatalogDetail } from '#catalog/content/parse.js';
+import { alignPackRows, pageSizeFor, truncate, visibleWidth } from '#cli/format.js';
+import { itemSectionHeader } from '#cli/prompts.js';
 export class AddItemCommand {
     _source;
     _pack;
@@ -17,41 +22,179 @@ export class AddItemCommand {
         this._agents = options.agents;
         this._guidelines = options.guidelines;
     }
-    execute(projectPath) {
+    async execute(projectPath, reporter) {
+        if (this._source !== undefined) {
+            const promptPack = this._pack === undefined;
+            const promptItems = this._skills === undefined && this._agents === undefined && this._guidelines === undefined;
+            if (promptPack && !promptItems) {
+                throw new Error('The --pack option is required with --skills, --agents, or --guidelines. e.g. --pack=git-workflow');
+            }
+            if ((promptPack || promptItems) && !canPrompt()) {
+                if (promptPack) {
+                    throw new Error('The --pack option is required (or run add-item in an interactive terminal). e.g. --pack=git-workflow');
+                }
+                throw new Error('No items to add. Specify at least one of --skills, --agents, or --guidelines (or run add-item in an interactive terminal).');
+            }
+            const optionItemsByType = promptItems
+                ? undefined
+                : {
+                    skills: this.parseItemNames(this._skills),
+                    agents: this.parseItemNames(this._agents),
+                    guidelines: this.parseItemNames(this._guidelines),
+                };
+            if (optionItemsByType) {
+                const totalInput = ITEM_TYPES.reduce((sum, type) => sum + optionItemsByType[type].length, 0);
+                if (totalInput === 0) {
+                    throw new Error('No items to add. Specify at least one of --skills, --agents, or --guidelines.');
+                }
+            }
+            const result = await this.addItemsFromSource({
+                projectPath,
+                sourceAlias: this._source,
+                packName: this._pack,
+                optionItemsByType,
+                reporter,
+            });
+            return { results: [result], failures: [] };
+        }
+        if (this._pack !== undefined) {
+            throw new Error('The --source option is required with --pack. e.g. --source=common');
+        }
+        const hasItemOptions = this._skills !== undefined || this._agents !== undefined || this._guidelines !== undefined;
+        if (hasItemOptions) {
+            throw new Error('The --source option is required with --skills, --agents, or --guidelines. e.g. --source=common');
+        }
+        if (!canPrompt()) {
+            throw new Error('The --source option is required (or run add-item in an interactive terminal). e.g. --source=common');
+        }
+        const configPath = buildCatalogConfigPath(projectPath);
+        const bySource = new Map();
+        const failures = [];
+        while (true) {
+            const config = loadConfig(configPath);
+            if (Object.keys(config.sources).length === 0) {
+                throw new Error(`no sources configured. run 'agent-bolt init' to add one.`);
+            }
+            const sourceAlias = await this.promptSourceSelection(config.sources, bySource);
+            if (sourceAlias === null)
+                break;
+            try {
+                const result = await this.addItemsFromSource({
+                    projectPath,
+                    sourceAlias,
+                    packName: undefined,
+                    optionItemsByType: undefined,
+                    reporter,
+                });
+                if (result.packs.length > 0) {
+                    const merged = bySource.get(sourceAlias);
+                    if (merged) {
+                        for (const pack of result.packs) {
+                            this.mergePackInto(merged.packs, pack);
+                        }
+                    }
+                    else {
+                        bySource.set(sourceAlias, result);
+                    }
+                }
+            }
+            catch (e) {
+                failures.push(e instanceof Error ? e.message : String(e));
+            }
+        }
+        return { results: [...bySource.values()], failures };
+    }
+    async addItemsFromSource(options) {
+        const { projectPath, sourceAlias, packName, optionItemsByType, reporter } = options;
         const configPath = buildCatalogConfigPath(projectPath);
         const config = loadConfig(configPath);
-        const source = config.sources[this._source];
+        const source = config.sources[sourceAlias];
         if (!source) {
-            throw new Error(`source '${this._source}' not found in ${configPath}`);
+            throw new Error(`source '${sourceAlias}' not found in ${configPath}`);
         }
-        const inputItemsByType = {
-            skills: this.parseItemNames(this._skills),
-            agents: this.parseItemNames(this._agents),
-            guidelines: this.parseItemNames(this._guidelines),
-        };
-        const totalInput = ITEM_TYPES.reduce((sum, type) => sum + inputItemsByType[type].length, 0);
-        if (totalInput === 0) {
-            throw new Error('No items to add. Specify at least one of --skills, --agents, or --guidelines.');
+        const interactive = packName === undefined || optionItemsByType === undefined;
+        const catalogDetail = this.resolveCatalogDetail(projectPath, sourceAlias, source, reporter, interactive);
+        if (packName !== undefined) {
+            const packDetail = catalogDetail.find((pack) => pack.name === packName);
+            if (!packDetail) {
+                throw new Error(`unknown pack in source '${sourceAlias}': ${packName}. run 'agent-bolt list-packs --source=${sourceAlias}' to see available packs.`);
+            }
+            const pack = await this.addItemsToPack({
+                configPath,
+                config,
+                sourceAlias,
+                packDetail,
+                optionItemsByType,
+            });
+            return { sourceAlias, packs: [pack] };
+        }
+        if (catalogDetail.length === 0) {
+            throw new Error(`source '${sourceAlias}' has no packs.`);
+        }
+        const packs = [];
+        while (true) {
+            const freshConfig = loadConfig(configPath);
+            const existingPacks = freshConfig.packs[sourceAlias] ?? {};
+            const hasSelectablePack = catalogDetail.some((pack) => {
+                const configuredPack = existingPacks[pack.name];
+                const { added, total } = this.countConfiguredItems(pack, configuredPack);
+                return added < total;
+            });
+            if (!hasSelectablePack) {
+                if (packs.length === 0) {
+                    console.log(chalk.dim(`  all items in source '${sourceAlias}' are already added`));
+                }
+                break;
+            }
+            const selectedPackName = await this.promptPackSelection(catalogDetail, sourceAlias, existingPacks);
+            if (selectedPackName === null)
+                break;
+            const packDetail = catalogDetail.find((pack) => pack.name === selectedPackName);
+            const pack = await this.addItemsToPack({
+                configPath,
+                config: freshConfig,
+                sourceAlias,
+                packDetail,
+                optionItemsByType: undefined,
+            });
+            if (this.countAddedItems(pack) > 0) {
+                this.mergePackInto(packs, pack);
+            }
         }
-        const catalogDir = resolveCatalogDir(projectPath, this._source, source);
-        const catalogDetail = parseCatalogDetail(catalogDir);
-        const packDetail = catalogDetail.find((packDetail) => packDetail.name === this._pack);
-        if (!packDetail) {
-            throw new Error(`unknown pack in source '${this._source}': ${this._pack}. run 'agent-bolt list-packs --source=${this._source}' to see available packs.`);
+        return { sourceAlias, packs };
+    }
+    mergePackInto(packs, pack) {
+        const existing = packs.find((existingPack) => existingPack.packName === pack.packName);
+        if (!existing) {
+            packs.push(pack);
+            return;
+        }
+        existing.packCreated = existing.packCreated || pack.packCreated;
+        for (const itemType of ITEM_TYPES) {
+            existing.addedItems[itemType].push(...pack.addedItems[itemType]);
+            existing.skippedItems[itemType].push(...pack.skippedItems[itemType]);
         }
+    }
+    async addItemsToPack(options) {
+        const { configPath, config, sourceAlias, packDetail, optionItemsByType } = options;
+        const packName = packDetail.name;
         const validItemsByType = {
             skills: new Set(packDetail.items.skills.map((item) => item.name)),
             agents: new Set(packDetail.items.agents.map((item) => item.name)),
             guidelines: new Set(packDetail.items.guidelines.map((item) => item.name)),
         };
         const guidelineRecommendations = new Map(packDetail.items.guidelines.map((guideline) => [guideline.name, guideline.recommended]));
-        const existingPacks = config.packs[this._source];
-        const existingPack = existingPacks ? existingPacks[this._pack] : undefined;
+        const existingPacks = config.packs[sourceAlias];
+        const existingPack = existingPacks ? existingPacks[packName] : undefined;
         const existingItemsByType = {
             skills: new Set(existingPack?.skills ?? []),
             agents: new Set(existingPack?.agents ?? []),
             guidelines: new Set(Object.keys(existingPack?.guidelines ?? {})),
         };
+        let inputItemsByType = optionItemsByType;
+        if (inputItemsByType === undefined) {
+            inputItemsByType = await this.promptItemSelection(sourceAlias, packDetail, existingItemsByType);
+        }
         const unknownItems = { skills: [], agents: [], guidelines: [] };
         const skippedItems = { skills: [], agents: [], guidelines: [] };
         const addedItems = { skills: [], agents: [], guidelines: [] };
@@ -75,15 +218,15 @@ export class AddItemCommand {
         if (hasUnknown) {
             const lines = ITEM_TYPES.filter((itemType) => unknownItems[itemType].length > 0).map((itemType) => `  ${itemType}: ${unknownItems[itemType].join(', ')}`);
             throw new Error([
-                `unknown items in pack '${this._pack}':`,
+                `unknown items in pack '${packName}':`,
                 lines.join('\n'),
-                `run 'agent-bolt list-items --source=${this._source} --pack=${this._pack}' to see available items.`,
+                `run 'agent-bolt list-items --source=${sourceAlias} --pack=${packName}' to see available items.`,
             ].join('\n'));
         }
         const addedCount = ITEM_TYPES.reduce((sum, type) => sum + addedItems[type].length, 0);
         if (addedCount > 0) {
             editConfigFile(configPath, (document) => {
-                const packPath = ['packs', this._source, this._pack];
+                const packPath = ['packs', sourceAlias, packName];
                 if (existingPack) {
                     for (const itemType of ITEM_TYPES) {
                         const itemNames = addedItems[itemType];
@@ -123,13 +266,155 @@ export class AddItemCommand {
             });
         }
         return {
-            sourceAlias: this._source,
-            packName: this._pack,
+            packName,
             packCreated: existingPack === undefined,
             addedItems,
             skippedItems,
         };
     }
+    resolveCatalogDetail(projectPath, sourceAlias, source, reporter, interactive) {
+        if (!interactive) {
+            const catalogDir = resolveCatalogDir(projectPath, sourceAlias, source);
+            return parseCatalogDetail(catalogDir);
+        }
+        reporter.start(`Resolving source '${sourceAlias}'`);
+        try {
+            const catalogDir = resolveCatalogDir(projectPath, sourceAlias, source);
+            const catalogDetail = parseCatalogDetail(catalogDir);
+            reporter.succeed(`source '${sourceAlias}'`);
+            return catalogDetail;
+        }
+        catch (e) {
+            reporter.stop();
+            throw e;
+        }
+    }
+    async promptSourceSelection(sources, bySource) {
+        const entries = Object.entries(sources);
+        const aliasWidth = Math.max(0, ...entries.map(([alias]) => alias.length));
+        const sourceChoices = entries.map(([alias, source]) => {
+            const location = source.type === 'local' ? source.path : source.url;
+            const added = bySource.get(alias);
+            const addedCount = added
+                ? added.packs.reduce((sum, pack) => sum + this.countAddedItems(pack), 0)
+                : 0;
+            const addedNote = addedCount > 0 ? chalk.dim(`  · added ${addedCount}`) : '';
+            return {
+                name: `${alias.padEnd(aliasWidth)}  ${chalk.dim(`(${source.type} · ${location})`)}${addedNote}`,
+                value: alias,
+                short: alias,
+            };
+        });
+        return select({
+            message: 'Select a source (or finish)',
+            choices: [...sourceChoices, new Separator(), { name: 'Done', value: null }],
+            loop: false,
+            pageSize: pageSizeFor(sourceChoices.length + 2),
+        });
+    }
+    countConfiguredItems(packDetail, existingPack) {
+        const existingItemsByType = {
+            skills: new Set(existingPack?.skills ?? []),
+            agents: new Set(existingPack?.agents ?? []),
+            guidelines: new Set(Object.keys(existingPack?.guidelines ?? {})),
+        };
+        let added = 0;
+        let total = 0;
+        for (const itemType of ITEM_TYPES) {
+            const catalogItems = packDetail.items[itemType];
+            const configuredItemNames = existingItemsByType[itemType];
+            for (const item of catalogItems) {
+                total += 1;
+                if (configuredItemNames.has(item.name))
+                    added += 1;
+            }
+        }
+        return { added, total };
+    }
+    async promptPackSelection(catalogDetail, sourceAlias, existingPacks) {
+        const rows = alignPackRows(catalogDetail.map((pack) => ({
+            name: pack.name,
+            counts: {
+                skills: pack.items.skills.length,
+                agents: pack.items.agents.length,
+                guidelines: pack.items.guidelines.length,
+            },
+        })));
+        const packChoices = rows.map((row) => {
+            const packDetail = catalogDetail.find((pack) => pack.name === row.name);
+            const { added, total } = this.countConfiguredItems(packDetail, existingPacks[row.name]);
+            let disabled = false;
+            let addedNote = '';
+            if (total === 0) {
+                disabled = '(no items)';
+            }
+            else if (added >= total) {
+                disabled = `(${added}/${total} added)`;
+            }
+            else if (added > 0) {
+                addedNote = chalk.dim(`  (${added}/${total} added)`);
+            }
+            return {
+                name: `${row.paddedName}  ${row.counts}${addedNote}`,
+                value: row.name,
+                short: row.name,
+                disabled,
+            };
+        });
+        return select({
+            message: `Select a pack in source '${sourceAlias}' (or finish)`,
+            choices: [...packChoices, new Separator(), { name: 'Done', value: null }],
+            loop: false,
+            pageSize: pageSizeFor(packChoices.length + 2),
+        });
+    }
+    async promptItemSelection(sourceAlias, packDetail, existingItemsByType) {
+        const empty = { skills: [], agents: [], guidelines: [] };
+        const nameWidth = Math.max(0, ...ITEM_TYPES.flatMap((itemType) => packDetail.items[itemType].map((item) => item.name.length)));
+        const hasSelectable = ITEM_TYPES.some((itemType) => packDetail.items[itemType].some((item) => !existingItemsByType[itemType].has(item.name)));
+        if (!hasSelectable) {
+            const totalItems = ITEM_TYPES.reduce((sum, itemType) => sum + packDetail.items[itemType].length, 0);
+            const note = totalItems === 0
+                ? `pack '${packDetail.name}' has no items`
+                : `all items in '${packDetail.name}' are already added`;
+            console.log(chalk.dim(`  ${note}`));
+            return empty;
+        }
+        const choices = [];
+        const rowWidth = Math.max(0, ...ITEM_TYPES.flatMap((itemType) => packDetail.items[itemType].map((item) => nameWidth + 2 + visibleWidth(truncate(item.description, 50)))));
+        for (const itemType of ITEM_TYPES) {
+            const items = packDetail.items[itemType];
+            if (items.length === 0)
+                continue;
+            if (choices.length > 0)
+                choices.push(new Separator(' '));
+            choices.push(itemSectionHeader(itemType, rowWidth));
+            for (const item of items) {
+                const alreadyAdded = existingItemsByType[itemType].has(item.name);
+                choices.push({
+                    name: `${item.name.padEnd(nameWidth)}  ${chalk.dim(truncate(item.description, 50))}`,
+                    value: { type: itemType, name: item.name },
+                    short: item.name,
+                    disabled: alreadyAdded ? '(already added)' : false,
+                });
+            }
+        }
+        const selected = await checkbox({
+            message: `Select items to add to '${sourceAlias}/${packDetail.name}'`,
+            choices,
+            loop: false,
+            pageSize: pageSizeFor(choices.length),
+            theme: { icon: { disabledUnchecked: '✓' } },
+        });
+        const result = { skills: [], agents: [], guidelines: [] };
+        for (const { type, name } of selected) {
+            result[type].push(name);
+        }
+        return result;
+    }
+    countAddedItems(pack) {
+        return ITEM_TYPES.reduce((sum, itemType) => sum + pack.addedItems[itemType].length, 0);
+    }
     parseItemNames(value) {
         if (!value)
             return [];