@shanepadgett/tau-agent

Tau is a custom agentic harness built with pi extensions

Packages

Package details

extensionskillthemeprompt

Install @shanepadgett/tau-agent from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@shanepadgett/tau-agent
Package
@shanepadgett/tau-agent
Version
0.23.0
Published
Jul 24, 2026
Downloads
3,633/mo · 1,849/wk
Author
shanepadgett
License
MIT
Types
extension, skill, theme, prompt
Size
810.6 KB
Dependencies
4 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/*/index.ts"
  ],
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@shanepadgett/tau-agent

Tau is a custom agentic harness built with Pi extensions: tools, commands, prompts, skills, and themes.

The package also exports programmatic Tau capabilities for trusted Pi extensions. The built-in extensions and public API use the same underlying operations.

Install

pi install npm:@shanepadgett/tau-agent
# or from git (monorepo root)
pi install git:github.com/shanepadgett/tau-agent
# local
pi install ./path/to/tau-agent
pi install ./path/to/tau-agent/packages/agent

Programmatic use

Install the package in the extension's project, then import from its root:

import { generateImage } from "@shanepadgett/tau-agent";

const image = await generateImage(ctx, {
  prompt: "A quiet mountain lake",
  path: "assets/lake.png",
  signal,
});

See Extending Tau Agent for the supported API.

Development

From the monorepo root:

npm install --ignore-scripts
mise run check
pi -e .

Docs