@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.55.0
Published
Oct 9, 2026
Downloads
4,631/mo · 1,993/wk
Author
shanepadgett
License
MIT
Types
extension, skill, theme, prompt
Size
13.9 MB
Dependencies
10 dependencies · 4 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "themes": [
    "./themes"
  ],
  "prompts": [
    "./prompts"
  ],
  "extensions": [
    "./extensions/*/index.ts"
  ]
}

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

This release supports Pi 1.1.0 exactly. Install that harness version before installing Tau:

npm install -g @earendil-works/pi-coding-agent@1.1.0

If a tool manager supplies Pi, set its Pi version to 1.1.0 instead. Check pi --version in the directory where you launch Tau. Pi supplies the harness libraries; Tau does not install a separate copy. Startup and /tau doctor report version mismatches when the Tau extension can load.

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 .

When updating Pi, change the root development dependency pins and the Pi peer pins in both published packages together, then update the installation examples. npm run check:package-sources verifies the pins before publishing. The runtime check reads the agent package's declared Pi peer version.

Docs