Nstbrowser AI Agent

Get started in 5 minutes with these examples:

Option 1: Using Temporary Browser (Fastest)

For quick tests or one-time tasks:

# 1. Start temporary browser
nstbrowser-ai-agent browser start-once
2. Open a website
nstbrowser-ai-agent open https://example.com
3. Take a snapshot
nstbrowser-ai-agent snapshot -i
4. Close browser (auto-cleanup)
nstbrowser-ai-agent close

Note: Temporary browsers don't save session state and are cleaned up after use.

Option 2: Using Profile (Recommended for Persistent Sessions)

For tasks that require saved sessions, cookies, or login state:

# 1. List available profiles
nstbrowser-ai-agent profile list
2. Create a new profile (if needed)
nstbrowser-ai-agent profile create my-profile
3. Open browser with profile (auto-starts if not running)
nstbrowser-ai-agent open https://example.com
4. Interact with page
nstbrowser-ai-agent snapshot -i
nstbrowser-ai-agent click @e1
5. Close browser (session saved to profile)
nstbrowser-ai-agent close

Expected Output:

Config File (Recommended)

Store configuration persistently in ~/.nst-ai-agent/config.json:

# Set API key (required)
nstbrowser-ai-agent config set key YOUR_API_KEY
Optional: Set custom host
nstbrowser-ai-agent config set host api.example.com
Optional: Set custom port
nstbrowser-ai-agent config set port 9000
View all configuration
nstbrowser-ai-agent config show
Get specific value
nstbrowser-ai-agent config get key

Configuration persists across sessions and takes priority over environment variables.

Environment Variables

Alternative to config file:

# Nstbrowser API credentials (required if not using config)
Set NST_API_KEY in your environment
Optional: Nstbrowser API endpoint
Set NST_HOST and NST_PORT if using custom endpoint
Optional: Specify profile for each command
nstbrowser-ai-agent open https://example.com --profile "my-profile"

Priority: Config file > Environment variables > Defaults

1. Use Profile Names: More readable than IDs for most use cases 2. Leverage Sticky Sessions: No need to repeat --profile flag once browser is running 3. Use Batch Operations: More efficient for multiple profiles 5. Organize with Groups and Tags: Keep profiles organized 6. Prefer CSS Selectors for Modern Apps: Refs may not work with Vue/React/Angular 7. Wait Appropriately: Use wait --load networkidle after navigation 8. Close Cleanly: Always close browser to save session state 9. Handle Errors: Check command output and retry if needed 10. Use Proxies Per Profile: Configure proxies for geo-targeting or privacy 11. Keep Updated: Run nstbrowser-ai-agent update check periodically