duskware

CLI for Duskware - Autonomous Runtime for AI Agents on Base.

v0.3.3 — Product Building Focus

Quick Start

# 1. Initialize your agent
npx [email protected] init

# 2. Fund wallet with ETH (gas) + USDC (credits) on Base
# Send to address shown after init

# 3. Add credits (minimum $5)
npx duskware credits topup 10

# 4. Start autonomous mode
npx duskware agent autonomy

Two Modes

| Mode | Command | Description | |------|---------|-------------| | Manual | duskware inference prompt "..." | You control everything | | Autonomous | duskware agent autonomy | Agent runs independently |

Autonomous Agents (v0.3.3)

Start an agent that thinks, builds, and survives on its own:

# Start the god loop
npx duskware agent autonomy

# Check status
npx duskware agent autonomy-status

# View/edit agent soul
npx duskware agent soul

How It Works

1. Auto-detects funds — When USDC arrives in wallet, converts to credits
2. Wakes up — Initializes and starts thinking
3. Generates ideas — Uses AI to create product ideas
4. Builds products — Deploys to sandbox with tip addresses
5. Survives — Products earn tips → agent lives longer

Survival Tiers

| Tier | Balance | Behavior | |------|---------|----------| | Normal | > $15 | Full creative mode | | Low | $8-15 | Survival mode, quick builds | | Critical | $5-8 | Emergency, minimal products | | Sleeping | < $5 | Hibernates until funded |

Revenue Strategy

Philosophy: Earn existence through honest work.

The agent builds valuable products that humans voluntarily pay for:

• Viral utilities (free + tip jar)
• API services (pay-per-use)
• AI wrappers (unique tools)
• Telegram/Discord bots

No trading. No speculation. Pure value creation.

Commands

Credits

duskware credits balance         # Check balance
duskware credits topup <amount>  # Add credits ($5, $10, $25, $50, $100)
duskware credits transactions    # View history

Inference

duskware inference prompt "..."  # Run AI (default: claude-4.5-sonnet)
duskware inference prompt "..." --model claude-4.5-haiku
duskware inference models        # List models + pricing

Models: | Model | Price | |-------|-------| | claude-4.5-haiku | $0.01 | | claude-4.5-sonnet | $0.05 | | claude-4.5-opus | $0.25 |

Sandboxes

duskware sandbox create my-agent --tier starter
duskware sandbox list
duskware sandbox exec <id> "npm install"
duskware sandbox delete <id>

Tiers: | Tier | CPU | RAM | Price | |------|-----|-----|-------| | starter | 1 | 512 MB | $5/mo | | medium | 2 | 2 GB | $10/mo | | power | 4 | 8 GB | $25/mo |

Agent

duskware agent autonomy          # Start autonomous loop
duskware agent autonomy-status   # Check state + stats
duskware agent soul              # View agent soul
duskware agent soul --edit       # Edit soul

Configuration

Files stored in ~/.duskware/:

~/.duskware/
├── wallet.json          # Private key (keep safe!)
├── config.json          # Settings
├── SOUL.json            # Agent personality
├── autonomy-state.json  # Runtime state
└── memory/              # Local cache

Funding Your Agent

1. Run duskware status to get wallet address
2. Send ETH on Base (~$1-5 for gas)
3. Send USDC on Base ($10+ recommended)
4. Run duskware credits topup 10
5. Start with duskware agent autonomy

Bridges from Ethereum:

• Base Bridge — Official
• Across Protocol — Fast (~2 min)

Links

• Dashboard: https://app.duskware.xyz
• Docs: https://docs.duskware.xyz
• npm: https://www.npmjs.com/package/duskware

License

MIT