# File Manager

> Open files with default applications, reveal files in explorer/finder, and search for files on the system. Requires approval for operations outside workspace.

- **Type:** Skill
- **Install:** `agentstack add skill-markdevshop-ag3nt-file-manager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [markdevshop](https://agentstack.voostack.com/s/markdevshop)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [markdevshop](https://github.com/markdevshop)
- **Source:** https://github.com/markdevshop/AG3NT/tree/main/skills/file-manager

## Install

```sh
agentstack add skill-markdevshop-ag3nt-file-manager
```

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

## About

# File Manager Skill

This skill provides file management operations on the local system. It can open files, reveal them in the file explorer, and search for files.

## ⚠️ Security Note

Operations on files **outside the workspace** require user approval. The agent will pause and ask for confirmation before:
- Opening files outside the current project
- Revealing files in external locations
- Executing any file operations on system directories

## When to Use

- User asks to "open" a document, image, or file
- User wants to "show in explorer" or "reveal in finder"
- User needs to find a file on their system
- User asks about file details (size, dates, type)

## Available Commands

### Open File
Opens a file with its default application.

```bash
python scripts/file_ops.py open "/path/to/document.pdf"
```

**Examples:**
- Open a PDF: `open ~/Documents/report.pdf`
- Open an image: `open ./screenshot.png`
- Open a URL: `open https://example.com`

### Reveal in Explorer/Finder
Shows the file in the system file manager, with the file selected.

```bash
python scripts/file_ops.py reveal "/path/to/file.txt"
```

### Search for Files
Search for files by name or pattern.

```bash
python scripts/file_ops.py search "*.pdf" --location ~/Documents
python scripts/file_ops.py search "report" --location ~/Documents --recursive
```

### Get File Info
Get detailed information about a file.

```bash
python scripts/file_ops.py info "/path/to/file.txt"
```

Returns: size, creation date, modification date, file type, permissions.

## Platform Support

| Operation | Windows | macOS | Linux |
|-----------|---------|-------|-------|
| Open file | ✅ `os.startfile` | ✅ `open` | ✅ `xdg-open` |
| Reveal | ✅ `explorer /select` | ✅ `open -R` | ✅ `xdg-open` (folder) |
| Search | ✅ `dir /s` | ✅ `mdfind` | ✅ `find` |

## Notes

- File paths can be absolute or relative to current directory
- Use forward slashes `/` or escaped backslashes `\\` on Windows
- URLs are also supported for the `open` command
- Search is case-insensitive on Windows and macOS

## Source & license

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

- **Author:** [markdevshop](https://github.com/markdevshop)
- **Source:** [markdevshop/AG3NT](https://github.com/markdevshop/AG3NT)
- **License:** MIT

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-markdevshop-ag3nt-file-manager
- Seller: https://agentstack.voostack.com/s/markdevshop
- 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%.