# Ferrisgrid Install

> Install and verify the published FerrisGrid CLI from crates.io. Use when setting up FerrisGrid, checking prerequisites, installing the ferrisgrid command, or confirming screen/input permissions.

- **Type:** Skill
- **Install:** `agentstack add skill-brunov21-ferrisgrid-cli-ferrisgrid-install`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BrunoV21](https://agentstack.voostack.com/s/brunov21)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [BrunoV21](https://github.com/BrunoV21)
- **Source:** https://github.com/BrunoV21/FerrisGrid-CLI/tree/main/.agents/skills/ferrisgrid-install
- **Website:** https://brunov21.github.io/FerrisGrid-CLI/

## Install

```sh
agentstack add skill-brunov21-ferrisgrid-cli-ferrisgrid-install
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# FerrisGrid Install

Use this when a machine needs the normal published FerrisGrid CLI. Only use a local checkout when the user explicitly asks for source development.

## Steps

1. Check Rust is available and whether `ferrisgrid` is already on `PATH`:

```bash
cargo --version
which ferrisgrid
```

If Rust is missing, tell the user Rust/Cargo must be installed before the published CLI can be installed.

2. Install or update the published CLI from crates.io. The crates.io package name is `ferrisgrid-cli`; it installs the executable named `ferrisgrid`:

```bash
cargo install ferrisgrid-cli
```

If this fails with DNS, crates.io index, or other network-related errors in a sandboxed agent environment, retry the same command with the normal escalation flow because `cargo install` needs network access.

3. Confirm the installed binary is available and responds:

```bash
which ferrisgrid
ferrisgrid help
```

Do not use `ferrisgrid --version` as the verification command unless the CLI has added that command; older releases report it as an unknown command.

4. Run diagnostics:

```bash
ferrisgrid doctor
```

On macOS, `doctor` can exit successfully while reporting native capture problems such as `CoreGraphics returned no displays` and `screens: 0`. Treat that as an environment or permission issue, not an install failure, if `ferrisgrid help` and the fake backend smoke test work.

5. Smoke-test capture without touching the real desktop:

```bash
ferrisgrid observe --backend fake
```

This verifies the CLI protocol and output writing path even when native desktop capture is unavailable.

## Development from source

Use these commands only inside a local FerrisGrid checkout when modifying the project:

```bash
cargo build -p ferrisgrid-cli
cargo test --workspace
cargo run -q -p ferrisgrid-cli -- doctor
```

## Notes

- On macOS, real capture needs Screen Recording permission.
- On macOS, real capture may also require running from a logged-in desktop session.
- Real actions need Accessibility permission.
- Default output is `.ferrisgrid/`.
- Use `--backend fake` only for protocol smoke tests; normal usage should use the native backend.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [BrunoV21](https://github.com/BrunoV21)
- **Source:** [BrunoV21/FerrisGrid-CLI](https://github.com/BrunoV21/FerrisGrid-CLI)
- **License:** MIT
- **Homepage:** https://brunov21.github.io/FerrisGrid-CLI/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-brunov21-ferrisgrid-cli-ferrisgrid-install
- Seller: https://agentstack.voostack.com/s/brunov21
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.