Skip to main content
Agentastic’s built-in browser can be driven programmatically by AI agents via dev browser commands. The browser-use skill is a markdown document that you install into your agent’s skill directory — once it is there, the agent knows what commands are available and how to use them. With the skill active, the agent can open pages, snapshot the DOM, click elements, fill forms, read console errors, check cookies and storage, and verify UI state, all without leaving the terminal. For more on the browser itself, see the browser feature overview.

​
Quick install

Run these two commands to create the skills directory and download the skill file:
After installing, ask your agent to use the skill:
“Use browser-use to open localhost:3000, snapshot the page, and verify the new header.”

​
Alternative: Use the hosted skill URL

Instead of downloading the file, you can point your agent directly at the hosted skill URL. This approach always gives the agent the latest version of the skill:
Tell your agent:
“Read https://agentastic.dev/skills/browser.md to learn how to use the browser, then check the UI at localhost:3000.”
For Claude Code, you can also pre-authorize dev browser commands in your project’s .claude/settings.json so the agent does not have to ask for permission each time:

​
Add the skill to a project

For team projects, commit the skill file directly into the repository so every agent that works on the project picks it up automatically:
When the skill file is present at .claude/skills/browser/SKILL.md, Claude Code uses auto-discovery to load it. The description field in the file tells the agent when to activate — so when you ask it to “check the UI” or “test the login page”, it loads the skill without any extra instructions from you.
The project-level skill is the right choice for most teams. It is checked into git and shared with everyone who works on the project. Use the hosted URL when you want to give an agent browser capabilities quickly without committing any files.

​
What the agent can do

The browser skill teaches agents 70+ commands across these categories: See the Browser CLI reference for detailed documentation on every command.

​
Usage examples

Ask: “Open localhost:3000 in the browser and check if the new header shows up.”The agent runs:
Ask: “Test the signup form at localhost:3000/signup with a fake user.”The agent runs:
Element references like @e2 come from the snapshot output — the agent reads them and uses them to target specific elements on the page.
Ask: “Check what cookies and local storage the site is setting.”The agent runs:
Ask: “The button on the homepage looks broken, check what CSS is applied.”The agent runs:
Ask: “Click the delete button and accept the confirmation.”The agent pre-configures the dialog response before triggering the action:
Ask: “Reload the page and check for any console errors.”The agent runs:

​
Scope options

Choose where to install the skill based on who should have access to it:

​
Customizing the skill

You can extend the downloaded skill file with project-specific notes. Add them at the end of the file so the agent loads them alongside the standard instructions:

​
Compatibility

The dev browser commands work from any terminal session inside Agentastic, regardless of which agent is running. The AGENTASTIC_SOCKET_PATH environment variable is injected automatically into every Agentastic terminal — agents do not need any additional setup to connect.