@quolu/aishell 0.4.7 → 0.4.9

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.ja.md CHANGED
@@ -13,6 +13,13 @@
13
13
 
14
14
  [English](README.md)
15
15
 
16
+ [kitepon.dev](https://kitepon.dev/)を運営する[クオ(@QLyun35332)](https://x.com/QLyun35332)が
17
+ 開発・メンテナンスしています。
18
+
19
+ **所有境界:** 本repositoryはApple Silicon Mac向けOS context runtimeを所有します。
20
+ 製品横断の導入・統合契約は、kitepon.devの製品開発を支える内部基盤
21
+ [dotagents](https://github.com/kitepon-rgb/dotagents)が担当します。
22
+
16
23
  AIShellは許可root、file identity、filesystem照合state、直接起動したprocess、完全log、artifactを所有する。reasoning、thread、compaction、sub-agent、汎用terminalはAI hostの責務として残す。
17
24
 
18
25
  ## 30秒で試す
@@ -22,7 +29,7 @@ Apple Silicon Mac、macOS 15以降が必要。
22
29
  ```sh
23
30
  npm install -g @quolu/aishell
24
31
  aishell-open
25
- codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
32
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
26
33
  ```
27
34
 
28
35
  管理アプリでAIに許可するfolderを追加し、新しいCodex taskで次のように頼む。
@@ -52,12 +59,15 @@ semantic search、project profile、Git branch/worktree modeが加わる。
52
59
  Codexでは次のように登録する。
53
60
 
54
61
  ```sh
55
- codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- /opt/homebrew/bin/aishell-mcp
62
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
56
63
  ```
57
64
 
58
65
  未知値または空の`AISHELL_CAPABILITY_SET`と`AISHELL_TOOL_PROFILE`はtyped errorでstartup停止し、
59
66
  別profileへ黙ってfallbackしない。
60
67
 
68
+ lexical `search_context`は`ranking`を省略できる。workspace cursorなしではtest path、
69
+ `changed_since_cursor`ありでは変更pathとtest pathを優先する。`changed`を明示する場合だけcursorを必須とする。
70
+
61
71
  ## なぜAIShellか
62
72
 
63
73
  statelessな連携では、モデルがworkspaceを何度もscanし、command出力から状態を再構成しやすい。AIShellは状態を持つOS側の仕事をモデルより下へ置き、後続turnが全再scanではなくdeltaと一次証拠を要求できるようにする。
@@ -120,10 +130,11 @@ MCP実行ファイルは`build/AIShell.app/Contents/Helpers/aishell-mcp`へ同
120
130
 
121
131
  ## 別のAI hostへ接続
122
132
 
123
- Homebrew prefixへnpm installした場合は絶対pathを登録する。
133
+ global npm install後は`PATH`上のcommand名とexpanded development surfaceを登録する。
124
134
 
125
135
  ```sh
126
- codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
136
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
137
+ claude mcp add --scope user aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
127
138
  codex mcp get aishell
128
139
  ```
129
140
 
package/README.md CHANGED
@@ -13,6 +13,13 @@
13
13
 
14
14
  [日本語](README.ja.md)
15
15
 
16
+ Built and maintained by [Quo](https://x.com/QLyun35332) at [kitepon.dev](https://kitepon.dev/en).
17
+
18
+ **Ownership boundary:** this repository owns the macOS Apple Silicon OS-context
19
+ runtime. Cross-product installation and the integration contract are handled by
20
+ [dotagents](https://github.com/kitepon-rgb/dotagents), the internal development
21
+ toolchain behind kitepon.dev's products.
22
+
16
23
  AIShell owns the OS-facing state below the model: allowed roots, file identity, filesystem reconciliation, directly launched processes, complete logs, and retained artifacts. The AI host remains responsible for reasoning, threads, compaction, sub-agents, and general-purpose terminal work.
17
24
 
18
25
  ## Try it in 30 seconds
@@ -22,7 +29,7 @@ Requires an Apple Silicon Mac running macOS 15 or later.
22
29
  ```sh
23
30
  npm install -g @quolu/aishell
24
31
  aishell-open
25
- codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
32
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
26
33
  ```
27
34
 
28
35
  In the manager app, add the folders the AI may access. Start a new Codex task and try:
@@ -49,11 +56,13 @@ Set `AISHELL_CAPABILITY_SET=expanded-v1` on the MCP server process to opt in to
49
56
  For Codex, register the expanded surface explicitly:
50
57
 
51
58
  ```sh
52
- codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- /opt/homebrew/bin/aishell-mcp
59
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
53
60
  ```
54
61
 
55
62
  Unknown or empty `AISHELL_CAPABILITY_SET` and `AISHELL_TOOL_PROFILE` values fail startup with typed errors; they never fall back to another profile.
56
63
 
64
+ For lexical `search_context`, omitting `ranking` is valid: requests without a workspace cursor prioritize tests, while requests with `changed_since_cursor` prioritize changed paths and tests. Explicit `changed` ranking still requires that cursor.
65
+
57
66
  `AISHELL_TOOL_PROFILE=factory` is a separate, one-tool surface for factory reporters rather than development work. It exposes only `factory_diagnostics`, a path- and activity-free native readiness report.
58
67
 
59
68
  ## Why AIShell
@@ -119,10 +128,11 @@ After opening the app, use **Add Allowed Root** to select the folders AIShell ma
119
128
 
120
129
  ## Connect another AI host
121
130
 
122
- For a Homebrew-prefix npm installation, register the absolute executable path:
131
+ For a global npm installation, register the executable name from `PATH` and the expanded development surface:
123
132
 
124
133
  ```sh
125
- codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
134
+ codex mcp add aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
135
+ claude mcp add --scope user aishell --env AISHELL_CAPABILITY_SET=expanded-v1 -- aishell-mcp
126
136
  codex mcp get aishell
127
137
  ```
128
138
 
@@ -17,7 +17,7 @@
17
17
  <key>CFBundlePackageType</key>
18
18
  <string>APPL</string>
19
19
  <key>CFBundleShortVersionString</key>
20
- <string>0.4.7</string>
20
+ <string>0.4.9</string>
21
21
  <key>CFBundleVersion</key>
22
22
  <string>17</string>
23
23
  <key>LSApplicationCategoryType</key>
@@ -10,19 +10,19 @@
10
10
  <dict>
11
11
  <key>cdhash</key>
12
12
  <data>
13
- sBvBMWV4PeVTUwSH29ZrcD5egCE=
13
+ anaRNMbBHcH6PhJxVGBEz4LHZ8I=
14
14
  </data>
15
15
  <key>requirement</key>
16
- <string>cdhash H"b01bc13165783de553530487dbd66b703e5e8021"</string>
16
+ <string>cdhash H"6a769134c6c11dc1fa3e1271546044cf82c767c2"</string>
17
17
  </dict>
18
18
  <key>Helpers/aishell-run-supervisor</key>
19
19
  <dict>
20
20
  <key>cdhash</key>
21
21
  <data>
22
- Ti7koED34tDM60MEjSGhA+c8P74=
22
+ MpFn7CH6ZbmZbNuooBEjzgYdRY8=
23
23
  </data>
24
24
  <key>requirement</key>
25
- <string>cdhash H"4e2ee4a040f7e2d0cceb43048d21a103e73c3fbe"</string>
25
+ <string>cdhash H"329167ec21fa65b9996cdba8a01123ce061d458f"</string>
26
26
  </dict>
27
27
  </dict>
28
28
  <key>rules</key>
package/package.json CHANGED
@@ -1,9 +1,12 @@
1
1
  {
2
2
  "name": "@quolu/aishell",
3
- "version": "0.4.7",
3
+ "version": "0.4.9",
4
4
  "description": "A native macOS state runtime with high-density MCP tools for AI development",
5
5
  "license": "Apache-2.0",
6
- "author": "quolu",
6
+ "author": {
7
+ "name": "Quo / クオ at kitepon.dev",
8
+ "url": "https://kitepon.dev/"
9
+ },
7
10
  "repository": {
8
11
  "type": "git",
9
12
  "url": "git+https://github.com/kitepon-rgb/aishell.git"