AI Agent Hub
Back to plugins
petween preview

petween

Fun & Dress-up Updated 2026.09.01

Run the following command in DeepSeek Harness:

dsh plugin install Traveritas/pbetween

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install Traveritas/petween in DeepSeek Harness to install this plugin, available at https://github.com/Traveritas/petween

About this plugin

Petween tackles a simple but real gap in DSH Web UI: the agent is working, yet the interface gives you no visual cue of what it is doing. Drop in a handful of static character images—one per state slot such as idle, thinking, and happy, with automatic fallback for missing ones—and the built-in Motion Engine turns them into a paper-cutout pet with comic-style squash-and-stretch transitions and looping Bounce, Sway, and Breathing animations. The pet tracks the agent's real event stream: it sways and bounces while the model is thinking, settles into a quiet breath while waiting for your approval, celebrates on success, and deflates on error. A state stabilizer keeps things calm during streaming output so the pet does not jitter through every token.\n\nBeyond simply moving, the plugin ships with a visual timeline editor where you drag keyframes, pick easing curves, and compose custom transitions or ambient loops. Every animation, built-in or custom, flows through the same WAAPI-based Timeline Compiler with no special-case branches. Finished animations can be exported as a single-file Motion Pack, and an entire pet—images, settings, and animations—can be zipped into a Pet Package for sharing, with automatic id-collision handling and content-hash image deduplication on import. Multiple pet presets let you configure independent pose images, state animations, and scale per character, and you can drag, resize, and pin the pet anywhere on the page while it respects the system prefers-reduced-motion setting.\n\nIt is aimed at three audiences: everyday DSH Web UI users who want a bit of personality in their tool; character creators who enjoy tweaking animations but would rather not write render-loop code; and plugin developers who want to build on top of petween's two cordis services (animation registry, stage snapshot subscription, position lease, and pose channel) that expose capability without imposing policy. The project is MIT-licensed; the demo character "Ming Yue" is used under a separate CC BY-NC-SA 4.0 license for demonstration purposes only.

Screenshots

Use Cases

  • Perceive agent thinking, working, and waiting states at a glance through an animated paper-cutout pet in DSH Web UI
  • Spin up a comic-style interactive pet from a few static images without writing render-loop code
  • Compose custom transition animations in the visual timeline editor and export them as a shareable Motion Pack

Best For

  • Everyday DSH Web UI users who want personality and clear agent-state feedback in their tool
  • Character creators who enjoy tweaking animations and poses without diving into render-loop internals
  • Plugin developers looking to build physics or interaction features on top of petween's cordis services