open-index/open-npm huggingface dataset:
npm package: @koder.com/files-plugin
Description: EpicClaw plugin for building and managing apps in koderAI workspaces.
Latest version: 1.0.5

# files-plugin

OpenClaw plugin that gives EpicClaw's AI agent direct access to koderAI workspace file operations.

## Overview

This plugin registers file management tools with OpenClaw, allowing the AI agent to create, read, update, and delete files and folders in a koderAI workspace. Authentication is handled via Bearer token — the plugin never exposes internal identifiers.

## Tools

| Tool | Description |
|------|-------------|
| `koder_list_files` | List files and folders in the workspace |
| `koder_get_file` | Get contents of a specific file |
| `koder_create_file` | Create a new file |
| `koder_update_file` | Update an existing file |
| `koder_upsert_file` | Create or update a file |
| `koder_delete_file` | Delete a file |
| `koder_create_folder` | Create a folder |
| `koder_delete_folder` | Delete a folder and its contents |
| `koder_rename_file` | Rename a file |
| `koder_rename_folder` | Rename a folder |
| `koder_export_zip` | Export workspace as a ZIP file |
| `koder_generate_markdown` | Combine all files into a single markdown document |

All tools support an optional `container` parameter (defaults to `code`).

## Installation

```bash
openclaw plugins install @koder.com/files-plugin
```

## Configuration

The plugin requires two config values in your OpenClaw config:

| Key | Description |
|-----|-------------|
| `apiUrl` | koderAI Core API base URL |
| `apiKey` | Bearer token for workspace authentication |

```bash
openclaw config set plugins.entries.koderai-files.enabled true
openclaw config set plugins.entries.koderai-files.config.apiUrl "<your-api-url>"
openclaw config set plugins.entries.koderai-files.config.apiKey "<your-api-key>"
```

Environment variable references are supported:

```json
{
  "plugins": {
    "entries": {
      "koderai-files": {
        "enabled": true,
        "config": {
          "apiUrl": "<your-api-url>",
          "apiKey": "${KODERAI_API_KEY}"
        }
      }
    }
  }
}
```

## Testing

```bash
npm install
npx tsx test.ts <bearer-token> [api-url]
```

## Dependencies

- `@sinclair/typebox` — JSON Schema generation for tool parameter definitions
- `openclaw` (peer) — OpenClaw plugin SDK types