🤖 Kiro Agent CLI

Kiro is a high-performance, AI-powered terminal assistant for the Solana blockchain. It acts as an intelligent co-pilot, letting you interact with your wallet, check balances, transfer funds, launch tokens, and manage configurations using simple, natural language.

No more copying long hex public keys, typing complex command arguments, or checking docs. Just chat with Kiro, and it handles the heavy lifting locally and securely.

🚀 Key Features

• 💬 Natural Language Interface: Converse with your wallet in plain text. Say "send 0.5 SOL to Bob" or "what's my devnet balance" and Kiro does the rest.
• 🔐 100% Non-Custodial & Secure: Kiro integrates directly with the native Solana CLI configuration (~/.config/solana/id.json). Your private keys never leave your machine.
• ✍️ Local Transaction Signing: Transactions are built, compiled, and signed locally in memory using @solana/web3.js. Kiro only broadcasts the finished, encrypted transaction to public RPC endpoints.
• 📊 Premium Verification Tables: Before sending a single lamport on-chain, Kiro renders a beautifully structured layout showing exact sender, recipient, amount, network, and RPC details.
• 🛑 Safe Double-Auth: Kiro halts and requires you to explicitly type yes to authorize any transaction, ensuring zero accidental transfers.
• 🪙 Instant Token Launcher: Spin up custom SPL tokens on Devnet in seconds by passing name, symbol, and metadata to Kiro.
• 🧩 Private Key Converter: Easily decode Phantom/Solflare base58 strings, seed phrases, or hex keys into the standard Solana CLI JSON byte array format.

📦 Installation

To install Kiro globally on your system, run:

npm install -g kiro-agent
# or using pnpm
pnpm add -g kiro-agent

🛠️ Quick Start

1. Initialize Kiro

Launch Kiro in interactive mode by typing:

kiro

2. Interactive Setup Wizard

On your first run, Kiro will guide you through a step-by-step setup:

• Solana CLI Verification: Kiro checks if the native Solana CLI is installed. If not, it helps you install it.
• Wallet Setup: Create a brand new local wallet or import an existing private key. (Keys are written securely to ~/.config/solana/id.json with owner-only 0o600 permissions).
• AI Engine Configuration: Choose between Google Gemini (native SDK) or Vercel AI Gateway, select your favorite model (e.g., Gemma 4 or GPT-4o), and enter your local API key.

3. Reset Configuration

Need to clear your setup or change your API keys? Simply run:

kiro config clear
# or
kiro --reset

🤖 Available AI Skills & Tools

| Skill | Description | Example Commands | | :--- | :--- | :--- | | get_wallet_info | View active wallet information. | "What is my active wallet address?" / "Show my public key." | | get_balance | Fetch native SOL balances in real-time. | "What is my balance?" / "How much SOL is in [address] on Mainnet?" | | transfer_sol | Transfer SOL locally & safely to other wallets. | "Send 0.2 SOL to [address]" / "Transfer 1.5 SOL to Bob" | | create_token | Launch a custom SPL token with Metaplex metadata. | "Create a token named 'KiroCoin' with symbol 'KIRO' using metadata [URI]" | | convert_private_key | Convert a raw private key string to a Solana CLI JSON array. | "Convert private key [key_string] to Solana CLI format" |

🔒 Security & Peace of Mind

Kiro was built from the ground up to respect crypto security best practices:

1. Zero Cloud Storage: We do not run servers that store or record your private keys. Everything is saved in your computer's standard local folders.
2. Strict File Permissions: Key files are written with 0o600 permissions, making them unreadable by other user profiles on your operating system.
3. Encrypted Inputs: Wallet setup uses a masked password input, keeping your secret key invisible to shoulder surfers.
4. Local Isolation: Private keys are loaded temporarily into active system memory solely for signing, then immediately garbage collected. The raw keys are never shared with the AI models or Vercel Gateway.

⚠️ Pro-Tip: Since AI chat conversations travel over-the-air to your model provider (Gemini or OpenAI), never paste high-value mainnet private keys directly into the conversational chat box. For setups, always use the secure interactive kiro setup wizard or the native solana-keygen tool.

🛠️ Local Development

If you want to build Kiro from source or contribute to its skills:

# Clone the repository
git clone https://github.com/AshutoshDM1/Web3-Frontier.git
cd Web3-Frontier/apps/cli

# Install dependencies
pnpm install

# Build the CLI (uses high-performance tsup)
pnpm build

# Run in development mode
pnpm dev

📄 License

MIT © AshutoshDM1/Web3-Frontier