@solana-agent-wallet-adapter/cli 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,107 @@
+# @solana-agent-wallet-adapter/cli
+
+Terminal control surface for Agentic, the Solana Agent Wallet Adapter local runtime. It starts a local wallet bridge, serves the browser wallet host, and lets agents request wallet-held approvals without receiving custody of a private key.
+
+## Install from npm
+
+```sh
+npm install -g @solana-agent-wallet-adapter/cli
+solana-agent-wallet app
+```
+
+One-shot usage without a global install:
+
+```sh
+npm exec @solana-agent-wallet-adapter/cli -- app
+```
+
+`solana-agent-wallet app` starts the local bridge at `http://127.0.0.1:8787`, starts the wallet host at `http://127.0.0.1:5174`, opens the wallet host in your browser, and launches the terminal control center.
+
+Optional AI planning is BYOK and local-first:
+
+```sh
+export AGENTIC_AI_API_KEY=...
+export AGENTIC_AI_MODEL=gpt-5
+export AGENTIC_AI_BASE_URL=https://api.openai.com/v1
+solana-agent-wallet app
+```
+
+The key stays in the local bridge process or your shell environment. The hosted app can draft plans through the bridge,
+but wallet approval remains separate.
+
+## Standalone Downloads
+
+Download the asset for your platform from the latest GitHub Release:
+
+- `solana-agent-wallet-macos-arm64.tar.gz`
+- `solana-agent-wallet-macos-x64.tar.gz`
+- `solana-agent-wallet-linux-x64.tar.gz`
+- `solana-agent-wallet-windows-x64.zip`
+
+Release URL pattern:
+
+```text
+https://github.com/mstevens843/solana-agent-wallet-adapter/releases/latest/download/<asset>
+```
+
+After extracting the archive, run:
+
+```sh
+./solana-agent-wallet app
+```
+
+On Windows, run `solana-agent-wallet.exe app`.
+
+## Commands
+
+```sh
+solana-agent-wallet app
+solana-agent-wallet doctor
+solana-agent-wallet bridge serve
+solana-agent-wallet bridge start
+solana-agent-wallet wallet-host serve
+solana-agent-wallet status
+solana-agent-wallet balances
+solana-agent-wallet connect
+solana-agent-wallet inbox list
+solana-agent-wallet inbox inspect <action-id>
+solana-agent-wallet inbox approve <action-id>
+solana-agent-wallet prepare transfer-sol <recipient> 0.01
+solana-agent-wallet receipts
+```
+
+Use `--json` for scriptable output.
+
+## Runtime Files
+
+Installed mode uses a user-local runtime directory:
+
+- macOS/Linux: `~/.solana-agent-wallet`
+- Windows: `%APPDATA%\solana-agent-wallet`
+
+The CLI creates `agent-wallet.config.json` and the prepared-action data directory when they are absent. Override paths with:
+
+```sh
+solana-agent-wallet --runtime-dir <path> doctor
+solana-agent-wallet --config <path> --prepared-actions <path> bridge serve
+```
+
+## Local Repo Development
+
+From a cloned repo:
+
+```sh
+pnpm install
+pnpm -F @solana-agent-wallet-adapter/cli build
+pnpm cli -- app
+```
+
+Repo mode keeps the development fallback for `apps/browser-demo` and repo-local config files. Public users should use npm, `npm exec`, or a release binary instead.
+
+## Troubleshooting
+
+- Run `solana-agent-wallet doctor --json` to inspect runtime paths, bridge reachability, wallet-host assets, and local health.
+- If port `8787` or `5174` is busy, stop the old process or pass `--bridge-url` / `--wallet-host-url` with another localhost port.
+- If no browser wallet is connected, keep the wallet host tab open, connect Phantom, Backpack, Solflare, or another Wallet Standard wallet, then click Connect bridge if prompted.
+- If `wallet-host serve` reports missing assets, reinstall the npm package or rebuild locally with `pnpm -F @solana-agent-wallet-adapter/cli build`.
+- Mainnet actions remain capped by `agent-wallet.config.json`; set `mainnet.enabled=true` only when you intend to allow real mainnet actions.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}