@quolu/aishell 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# AIShell
+
+AIがshell、Terminal、AppleScript、JXAを介さず、SwiftのmacOS APIを通してOSを直接操作する実験プロジェクト。
+
+## 現在できること
+
+- 許可フォルダ内の一覧、検索、UTF-8テキスト読取
+- フォルダ／テキスト作成、copy、move、rename、Trash
+- stat、SHA-256、再帰tree
+- SHA-256競合検出付き原子的更新、旧テキストを事前条件にした部分置換
+- executable URLと引数配列による開発プログラムの直接実行
+- working directory、環境変数、timeout、stdout、stderr、終了コードの取得
+- 実行中／インストール済みアプリの一覧
+- bundle identifierによるアプリ起動・前面化
+- 管理アプリから許可フォルダ選択、全停止、操作履歴確認
+- MCP 2025-11-25 stdio接続
+
+## 起動
+
+### npmからインストール
+
+対応環境はApple Silicon Mac、macOS 15以降。
+
+```text
+npm install -g @quolu/aishell
+open ~/Applications/AIShell.app
+```
+
+global installは `AIShell.app` を `~/Applications` へ配置し、`aishell-mcp` コマンドをPATHへ追加する。現在はDeveloper ID署名・notarization前の実験版である。
+
+### ソースから起動
+
+ローカル成果物は `build/AIShell.app`。Finderから通常のMacアプリとして起動できる。
+
+最初に「フォルダを選択」でAIに操作させる範囲を選ぶ。停止中はMCPからのファイル操作とアプリ操作をどちらも拒否する。
+
+MCP実行ファイルはアプリ内に同梱される。
+
+```text
+/Users/kite/Developer/aishell/build/AIShell.app/Contents/Helpers/aishell-mcp
+```
+
+## 別のCodexタスクから使う
+
+個人用のグローバルMCPとして登録する。npm版ではPATH上の絶対パスを指定する。
+
+```text
+codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
+```
+
+このMacでは登録済み。新しく開始したCodexタスクから `aishell` の19ツールを利用できる。操作を許可するときは `AIShell.app` を開いて対象フォルダを確認し、「AI操作を再開」を押す。停止中も `runtime_status` は使えるが、ファイル、アプリ、process操作は拒否される。
+
+登録確認と解除は次のとおり。
+
+```text
+codex mcp get aishell
+codex mcp remove aishell
+```
+
+## 開発検証
+
+```text
+swift test
+scripts/package-app.sh release
+```
+
+`xcodegen generate` で `AIShell.xcodeproj` を再生成できる。現在の検証機ではXcode 26.6とCoreSimulatorのbuild versionが一致せず、`xcodebuild` はXCBuild開始待ちで停止するため、同じSwift 6.3.3 toolchainを使うSwiftPMでビルド・テストした。この環境問題はソースの成功扱いへ混ぜていない。
+
+## 実装上の禁止事項
+
+`AIShellCore` と `AIShellMCP` は、shell、AppleScript、JXA、コマンド文字列を実行しない。開発プログラムは実行ファイルの絶対パスと引数配列を分離したままmacOSのprocess APIへ渡し、shell本体の起動、パイプ、リダイレクト、shell展開を拒否する。MCPは型付き要求をmacOSネイティブAPIへ渡すアダプターである。

package/dist/AIShell.app/Contents/Info.plist

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>ja</string>
+    <key>CFBundleDisplayName</key>
+    <string>AIShell</string>
+    <key>CFBundleExecutable</key>
+    <string>AIShell</string>
+    <key>CFBundleIdentifier</key>
+    <string>dev.kite.aishell</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>AIShell</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>0.1.0</string>
+    <key>CFBundleVersion</key>
+    <string>1</string>
+    <key>LSApplicationCategoryType</key>
+    <string>public.app-category.utilities</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>15.0</string>
+    <key>NSHighResolutionCapable</key>
+    <true/>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+</dict>
+</plist>

package/dist/AIShell.app/Contents/_CodeSignature/CodeResources

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict/>
+	<key>files2</key>
+	<dict>
+		<key>Helpers/aishell-mcp</key>
+		<dict>
+			<key>cdhash</key>
+			<data>
+			koF5aqCXOuiIDbAFGjF42v8yWDo=
+			</data>
+			<key>requirement</key>
+			<string>cdhash H"9281796aa0973ae8880db0051a3178daff32583a"</string>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^Resources/</key>
+		<true/>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^[^/]+$</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@quolu/aishell",
+  "version": "0.1.0",
+  "description": "A native macOS MCP server for direct file, app, and development tool operations without a shell",
+  "license": "UNLICENSED",
+  "author": "quolu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kitepon-rgb/aishell.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kitepon-rgb/aishell/issues"
+  },
+  "homepage": "https://github.com/kitepon-rgb/aishell#readme",
+  "keywords": [
+    "mcp",
+    "macos",
+    "swift",
+    "ai",
+    "automation"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "bin": {
+    "aishell-mcp": "dist/AIShell.app/Contents/Helpers/aishell-mcp"
+  },
+  "files": [
+    "dist/AIShell.app",
+    "scripts/install-npm-app.mjs",
+    "README.md"
+  ],
+  "scripts": {
+    "build:npm": "node scripts/prepare-npm-release.mjs",
+    "prepack": "npm run build:npm",
+    "postinstall": "node scripts/install-npm-app.mjs",
+    "test": "swift test",
+    "test:package": "npm run build:npm && node scripts/verify-npm-package.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install-npm-app.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import { access, mkdir, rename, rm } from "node:fs/promises";
+import { spawnSync } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+if (process.env.npm_config_global !== "true") {
+  console.log("AIShell.app installation skipped because this is not a global npm install.");
+  process.exit(0);
+}
+
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const packageDirectory = path.dirname(scriptDirectory);
+const sourceApp = path.join(packageDirectory, "dist", "AIShell.app");
+const applicationsDirectory = process.env.AISHELL_APPLICATIONS_DIR
+  ? path.resolve(process.env.AISHELL_APPLICATIONS_DIR)
+  : path.join(os.homedir(), "Applications");
+const targetApp = path.join(applicationsDirectory, "AIShell.app");
+const temporaryApp = path.join(applicationsDirectory, `.AIShell.installing-${process.pid}.app`);
+const previousApp = path.join(applicationsDirectory, "AIShell.previous.app");
+
+await access(sourceApp);
+await mkdir(applicationsDirectory, { recursive: true });
+await rm(temporaryApp, { recursive: true, force: true });
+
+const copy = spawnSync("/usr/bin/ditto", [sourceApp, temporaryApp], {
+  stdio: "inherit"
+});
+
+if (copy.error) {
+  throw copy.error;
+}
+
+if (copy.status !== 0) {
+  throw new Error(`AIShell.app copy failed with status ${copy.status}`);
+}
+
+let hadPreviousInstallation = false;
+
+try {
+  await access(targetApp);
+  hadPreviousInstallation = true;
+} catch {
+  hadPreviousInstallation = false;
+}
+
+if (hadPreviousInstallation) {
+  await rm(previousApp, { recursive: true, force: true });
+  await rename(targetApp, previousApp);
+}
+
+try {
+  await rename(temporaryApp, targetApp);
+} catch (error) {
+  if (hadPreviousInstallation) {
+    await rename(previousApp, targetApp);
+  }
+  throw error;
+}
+
+console.log(`Installed AIShell.app at ${targetApp}`);