npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@appautomaton/automaton

v0.3.10

Published

Portable, stage-gated agentic-AI harness for Claude Code, Codex, and OpenCode.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

appautomatonappautomaton

Keywords

ai-agentai-coding-assistantai-toolsagentic-aiagentic-workflowsautomationclaude-codecodexcontext-windowdeveloper-toolsllmopencodeprompt-engineeringskillsworkflow

Readme

Automaton

npm version license node site

Portable, stage-gated agentic-AI harness for Claude Code, Codex, and OpenCode.

An AI coding agent framework that gives LLM-powered development tools structured workflows for long-running tasks. Automaton installs markdown skills, lightweight startup integrations, and durable .agent/ state into a project so agent work survives context window limits, session restarts, and multi-step changes that would otherwise lose coherence.

Why Use It

  • Keep project truth, current work, and handoff state outside the chat window.
  • Move larger changes through explicit frame, plan, execute, and verify stages.
  • Use the same workflow across Claude Code, Codex, and OpenCode.

Install

Run from the project you want to equip:

npx @appautomaton/automaton install --codex
npx @appautomaton/automaton install --claude
npx @appautomaton/automaton install --opencode

Install all supported host surfaces:

npx @appautomaton/automaton install --all

The target root is optional and defaults to the current directory. To install into another project, pass its path as the final argument.

Host flags pick what to install: --claude, --codex, --opencode, or --all. Without a host flag, install prepares only the shared .agent runtime and prints a note saying so. The default runs the other way on removal: install --uninstall without a host flag removes every installed host plus the shared runtime, while .agent project history is always preserved.

What It Adds

  • .agent/ durable project state, steering, work artifacts, and runtime files
  • host skills under .codex/skills, .claude/skills, or .opencode/skills
  • host hooks/plugins for context injection

Automaton is copy-based: installed skills are local plain markdown files that are refreshed from source on reinstall and can be inspected in the target project.

Workflow

office-hours -> frame -> plan -> engineering review (optional) -> execute -> verify -> verified

The user approving SPEC.md at frame's exit is the product review; no model gate stands in for product judgment.

Most changes start at auto-frame, move through auto-plan, then continue with auto-execute and auto-verify. A full verification pass closes the change as verified (terminal). Use auto-onboard when project steering is missing or stale, auto-office-hours when the objective is still too broad, and auto-resume to re-enter existing work from a fresh session at any point.

Useful Commands

Run package commands through npx @appautomaton/automaton:

npx @appautomaton/automaton status
npx @appautomaton/automaton validate
npx @appautomaton/automaton install --uninstall --codex

status also warns when installed copies drift from the CLI source: a missing install receipt, a version skew, or an orphaned skill a newer version removed.

Contributor Docs

Contributor-only design and runtime notes live in the repository docs/ directory; they are not included in the npm package payload.

Links

Acknowledgement

🖤🤍💛 Thanks to Linux Do for their vibrant AI development community. 🖤🤍💛

License

MIT