@tuttiai/filesystem

Filesystem voice for Tutti — gives agents the ability to read, write, and search files on the local filesystem.

Install

npm install @tuttiai/filesystem

Usage

import { TuttiRuntime, AnthropicProvider, defineScore } from "@tuttiai/core";
import { FilesystemVoice } from "@tuttiai/filesystem";

const score = defineScore({
  provider: new AnthropicProvider(),
  agents: {
    assistant: {
      name: "assistant",
      model: "claude-sonnet-4-20250514",
      system_prompt: "You are a helpful assistant with filesystem access.",
      voices: [new FilesystemVoice()],
    },
  },
});

const tutti = new TuttiRuntime(score);
const result = await tutti.run("assistant", "List all .ts files in ./src");
console.log(result.output);

Tools

| Tool | Description | |---|---| | read_file | Read file contents (utf-8 or base64) | | write_file | Write or append to files | | list_directory | List files with optional glob filtering | | create_directory | Create directories recursively | | delete_file | Delete files with safety confirmation | | move_file | Move or rename files and directories | | search_files | Search file contents by text pattern |

All tool inputs are validated with Zod. Errors are returned as structured results — never thrown.

Links

• Tutti
• GitHub
• Voice Registry

License

Apache 2.0