open-index/open-npm huggingface dataset:
npm package: @perstack/base
Description: Perstack base skills for agents.
Author: Wintermute Technologies, Inc.
Latest version: 0.0.83

# @perstack/base

Base skills (MCP tools) for Perstack agents.

For detailed documentation, see [Base Skill](https://github.com/perstack-ai/perstack/blob/main/docs/making-experts/base-skill.md).

## Installation

```bash
npm install @perstack/base
```

## Usage

### As MCP Server

Run directly via npx:

```bash
npx @perstack/base
```

### As Library

Import and register tools with your MCP server:

```typescript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
import { registerReadTextFile, registerWriteTextFile } from "@perstack/base"

const server = new McpServer({ name: "my-server", version: "1.0.0" })

registerReadTextFile(server)
registerWriteTextFile(server)
```

## Available Tools

### File Operations
- `readTextFile` - Read text files with optional line range
- `writeTextFile` - Create or overwrite text files
- `editTextFile` - Replace text in existing files
- `readImageFile` - Read image files (PNG, JPEG, GIF, WebP)
- `readPdfFile` - Read PDF files

### Utilities
- `exec` - Execute system commands
- `todo` - Task list management
- `clearTodo` - Clear task list
- `attemptCompletion` - Signal task completion (validates todos first)

## License

Apache-2.0