auramaxx 0.0.20 → 0.1.1

package/skills/auramaxx/SKILL.md

@@ -1,136 +0,0 @@
----
-name: auramaxx
-description: |
-  AuraMaxx — local secrets manager, credential agent, and crypto wallet.
-  TRIGGER when: user mentions secrets, credentials, passwords, API keys, tokens,
-  wallets, sending/swapping/funding crypto, login details, credit card info,
-  sharing secrets, or "auramaxx"/"aura" by name.
-  Also trigger for: "log into my <service>", "what is my <service> password",
-  "run this with my <secret>", injecting env vars from stored credentials,
-  diary/logging entries, or wallet balance/transaction requests.
-  DO NOT TRIGGER when: general env var discussion unrelated to secret storage,
-  generic auth/login code implementation, or non-AuraMaxx wallet code.
-  Provides: secret CRUD (list/get/set/inject/share/delete), human-approval auth
-  flows, crypto wallet ops (send/swap/fund/balance), daily diary logging, and
-  MCP tool integration. Prefer MCP tools when available; fall back to CLI.
-compatibility: Requires Node.js 18+ with local AuraMaxx runtime.
-allowed-tools: Bash(npx auramaxx *), Bash(auramaxx *), Bash(aura *), Bash(curl *)
-metadata:
-  author: auramaxx
-  version: "3.1"
----
-
-# AuraMaxx
-
-Local secrets manager, credential agent, and crypto wallet for AI-assisted workflows.
-
-## When To Use
-
-Always use this skill when user intent matches any of these:
-
-- "log into my <site/service>" (example: "log into my facebook")
-- "what is my <site/service> password"
-- "find my <service> api key/token"
-- "give me my credit card details"
-- "run this command with my <secret>"
-- "store/save this secret/key/password"
-- "share my <credential> with someone"
-- "send/swap/fund crypto" or "check my wallet balance"
-- "write a diary entry" or "log this"
-- any mention of "auramaxx" or "aura" as a tool/service
-
-## Prerequisites
-
-If AuraMaxx is not installed:
-
-```bash
-npm install -g auramaxx
-auramaxx
-```
-
-Or without global install: `npx auramaxx` (always works with Node.js 18+).
-
-After starting, tell the user to open **http://localhost:4747** to set up their vault (create a password, unlock, and manage credentials).
-
-## Retrieval Flow (Do This First)
-
-For login/API key/card/password requests:
-
-1. Use `npx auramaxx get SECRET` first to trigger the protected read.
-2. If it returns `reqId` + `approveUrl`, send the `approveUrl` to the human.
-3. After approval, claim the request by `reqId`.
-4. Retry the original read once with `--reqId`.
-
-Examples:
-
-```bash
-npx auramaxx get SECRET
-aura auth claim <reqId> --json
-npx auramaxx get SECRET --reqId <reqId>
-```
-
-If you need to find the exact credential name first, list with a scoped query:
-
-```bash
-aura list --name facebook --json
-aura list --name facebook --field username --json
-```
-
-## Concrete CLI Examples
-
-```bash
-# Health
-
-aura status
-
-# List
-
-aura list
-aura list --name facebook --json
-
-# Read
-
-aura get FACEBOOK_LOGIN
-aura get FACEBOOK_LOGIN --field password --first
-
-# Create/update
-
-aura set FACEBOOK_LOGIN hunter2 --type login --field password --username alice
-aura set STRIPE_KEY sk_live_123 --type apikey --tags prod,api
-
-# Use secret in a command (preferred vs printing)
-aura inject OPENAI_API_KEY --env OPENAI_API_KEY -- node app.js
-
-# Share / delete
-aura share FACEBOOK_LOGIN --expires-after 24h
-aura del FACEBOOK_LOGIN
-
-# Approval flow
-aura auth request --agent-id codex --profile dev
-aura auth claim <reqId> --json
-aura get FACEBOOK_LOGIN --reqId <reqId>
-```
-
-## 403 Handling
-
-If the denial response includes `reqId` + `approveUrl`:
-
-1. Send the human the direct `approveUrl`.
-2. Claim with `aura auth claim <reqId> --json`.
-3. Retry the original command with `--reqId <reqId>`.
-
-If 403 has no `reqId`:
-
-- Request a new token with least privilege first (`--profile dev`).
-- Use `--profile admin` only when route explicitly requires admin.
-
-## Guardrails
-
-- For commands, use `inject`, not plaintext copy/paste.
-- Do not print secrets unless user explicitly asks for plaintext output.
-- Prefer `aura` alias (`npx auramaxx` equivalent).
-
-## Full Reference
-
-- CLI examples and command reference: `docs/CLI.md`
-- Auth flow details: `docs/AUTH.md`

package/skills/auramaxx/docs/AGENT_SETUP.md

@@ -1,160 +0,0 @@
-# Agent Setup
-
-Make sure AuraMaxx is running first:
-
-```bash
-auramaxx
-auramaxx status
-```
-
----
-
-## What are you using?
-
-| Client | Setup |
-|--------|-------|
-| 🦞 OpenClaw | [Skills](#skills) |
-| 🤖 Claude Code | [Skills](#skills) |
-| 📟 Codex CLI | [Skills](#skills) |
-| 🖥️ Claude Desktop | [MCP](#mcp) |
-| 🖱️ Cursor IDE | [MCP](#mcp) |
-| 🏄 Windsurf | [MCP](#mcp) |
-| 🚀 Antigravity | [MCP](#mcp) |
-| 🔌 VS Code + Continue | [MCP](#mcp) |
-| 🧩 Any MCP client | [MCP](#mcp) |
-
----
-
-## Skills
-
-Skills give your agent built-in knowledge of AuraMaxx commands and workflows.
-
-Install all at once:
-
-```bash
-auramaxx skill
-```
-
-Or install per client:
-
-### 🤖 Claude Code
-
-```bash
-auramaxx skill --claude
-
-# Or manually, from your project:
-mkdir -p .claude/skills
-cd .claude/skills
-npx -y skills add Aura-Industry/auramaxx
-```
-
-Installs to `~/.claude/skills/auramaxx`.
-
-### 📟 Codex CLI
-
-```bash
-auramaxx skill --codex
-
-# Or manually, from anywhere:
-mkdir -p ~/.codex/skills
-cd ~/.codex/skills
-npx -y skills add Aura-Industry/auramaxx
-```
-
-Installs to `~/.codex/skills/auramaxx`.
-
-### 🦞 OpenClaw
-
-```bash
-auramaxx skill --openclaw
-
-# Or manually, install globally for all OpenClaw agents:
-mkdir -p ~/.openclaw/skills
-cd ~/.openclaw/skills
-npx -y skills add Aura-Industry/auramaxx
-
-# Or install into your workspace (project-local):
-mkdir -p skills
-cd skills
-npx -y skills add Aura-Industry/auramaxx
-```
-
-Global installs to `~/.openclaw/skills/auramaxx`. Workspace installs to `./skills/auramaxx` (OpenClaw resolves workspace-local `skills/` first).
-
-### Other clients
-
-```bash
-cd <your-codebase>
-npx -y skills add Aura-Industry/auramaxx
-```
-
-### Verify
-
-```bash
-auramaxx skill --doctor
-```
-
----
-
-## MCP
-
-MCP gives your agent direct tool access to the agent (read secrets, write secrets, manage wallets). If your client supports [Skills](#skills), use those instead — they're simpler and don't require a running server connection.
-
-Auto-configure all detected clients at once:
-
-```bash
-auramaxx mcp --install
-```
-
-Or paste this config block into your client's MCP config:
-
-```json
-{
-  "mcpServers": {
-    "auramaxx": {
-      "command": "npx",
-      "args": ["auramaxx", "mcp"]
-    }
-  }
-}
-```
-
-### 🤖 Claude Code
-
-```bash
-claude mcp add auramaxx -- npx auramaxx mcp
-```
-
-### 📟 Codex CLI
-
-```bash
-codex mcp add auramaxx -- npx auramaxx mcp
-```
-
-### Where to paste the config block
-
-- 🖥️ **Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
-- 🖱️ **Cursor IDE** — MCP settings JSON editor
-- 🏄 **Windsurf** — `~/.windsurf/mcp.json`
-- 🔌 **VS Code + Continue** — `.vscode/mcp.json` in your project
-- 🦞 **OpenClaw** — add stdio server `npx auramaxx mcp` in MCP settings
-
-Restart your client after saving.
-
----
-
-## Verify
-
-```bash
-auramaxx get OURSECRET
-```
-
-Then ask your agent:
-
-`Use auramaxx skill to get OURSECRET.`
-
----
-
-## Troubleshooting
-
-See [TROUBLESHOOTING.md](TROUBLESHOOTING.md).

package/skills/auramaxx/docs/API.md

@@ -1,127 +0,0 @@
-# AuraMaxx API
-
-This file is the **API entrypoint** for agents.
-
-Use this page for the common path, then jump to the deep reference docs listed below.
-
-Server base URL:
-
-```text
-http://localhost:4242
-```
-
-## Common Path (Agent First)
-
-### 1) Request an agent token
-
-```http
-POST /auth
-Content-Type: application/json
-
-{
-  "agentId": "my-agent",
-  "profile": "strict",
-  "profileVersion": "v1",
-  "pubkey": "<RSA public key PEM or base64>",
-  "action": {                          // optional: auto-execute on approval
-    "endpoint": "/send",
-    "method": "POST",
-    "body": { "to": "0x...", "amount": "0.01" }
-  }
-}
-```
-
-When `action` is provided, the pre-computed action auto-executes with the newly-minted token after human approval.
-
-Human approves in dashboard, then poll:
-
-```http
-GET /auth/:requestId?secret=:secret
-```
-
-### 2) Read a secret (`get_secret`)
-
-`get_secret` maps to credential APIs under the hood:
-
-- find credential metadata: `GET /credentials`
-- read encrypted fields: `POST /credentials/:id/read`
-
-### 3) Set/update a secret (`put_secret`)
-
-Most common write path:
-
-```http
-POST /credentials
-```
-
-Update existing credential:
-
-```http
-PUT /credentials/:id
-```
-
-### 4) Write diary (`write_diary`)
-
-```http
-POST /what_is_happening/diary
-```
-
-### 5) Call broader APIs (`wallet_api`)
-
-Common starts:
-
-```http
-GET /wallets
-GET /token/search?q=PEPE&chain=base
-POST /wallet/create
-POST /send
-POST /swap
-POST /fund
-```
-
-If you get `403`, request human approval via `POST /auth` (include an `action` field for auto-execute on approval).
-
-## Quick Common Endpoints
-
-| Endpoint | Method | Typical Use |
-|---|---|---|
-| `/auth` | POST | Request token (approval flow) |
-| `/auth/:requestId?secret=...` | GET | Poll token request status |
-| `/credentials` | GET | List credential metadata |
-| `/credentials` | POST | Create credential |
-| `/credentials/:id/read` | POST | Read credential (encrypted response) |
-| `/credentials/:id` | PUT | Update credential |
-| `/credential-shares` | POST | Create share link |
-| `/credential-shares/gist` | POST | Create GitHub secret gist share |
-| `/what_is_happening/diary` | POST | Append diary note (entries are separated by a blank line) |
-| `/wallets` | GET | List wallets |
-
-## Read More In Depth (Complete API Docs Map)
-
-All API docs files are listed here. Keep this section updated when adding/moving API docs.
-
-### Getting Started
-
-- `docs/API.md` (this file)
-- [`docs/api/authentication.md`](/api?doc=api/authentication.md)
-
-### Secrets
-
-- [`docs/api/secrets/credentials.md`](/api?doc=api/secrets/credentials.md)
-- [`docs/api/secrets/sharing.md`](/api?doc=api/secrets/sharing.md)
-- [`docs/api/secrets/api-keys.md`](/api?doc=api/secrets/api-keys.md)
-
-### Wallets
-
-- [`docs/api/wallets/core.md`](/api?doc=api/wallets/core.md)
-- [`docs/api/wallets/data-portfolio.md`](/api?doc=api/wallets/data-portfolio.md)
-- [`docs/api/wallets/apps-strategies.md`](/api?doc=api/wallets/apps-strategies.md)
-
-### System
-
-- [`docs/api/system.md`](/api?doc=api/system.md)
-
-## Related Docs
-
-- [AUTH.md](AUTH.md) — full auth/permission model
-- [MCP.md](MCP.md) — MCP tools and usage