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

@jun133/kitty

v0.0.36

Published

Agent

Readme

Kitty Agent

如何设计一个智能体

从工具循环开始,理解目标、使用工具、持续行动,完成任务。

官网 · 快速开始 · 技术规格 · 开发规则

一个模型,如何成为真正的智能体?

模型很会思考,也很会表达,但仅仅拥有一个聊天框,它仍然只能给出答案。

真正的智能体需要看见外部世界,需要采取行动,需要记住已经发生的事情,也需要在漫长、复杂甚至随时可能中断的任务中继续向前。

Kitty 展示了这个过程:从最简单的工具循环开始,一步一步为模型装上行动、记忆、上下文、计划、后台执行和恢复能力,最终组装成一个能够持续完成任务的智能体。

从会回答,到会完成

第一步:让模型能够行动

工具把模型与真实世界连接起来。

它可以读取资料、修改文件、运行命令、查看结果。每一次工具调用都会产生新的事实,模型根据这些事实继续判断:下一步该做什么,是否需要再次行动,任务是否真的已经完成。

这就是 Agent Loop,也是 Kitty 的起点。

第二步:让每次行动都有连续性

一次请求可以给出一个答案,但复杂任务往往需要很多轮判断。

Kitty 用 session 保存对话和任务现场,用 context 组织当前真正需要的信息,用 skills 提供已经沉淀好的做事方法。即使任务很长,模型仍然知道自己正在做什么、已经确认了什么、接下来还要完成什么。

第三步:让复杂任务持续推进

真正的工作不会永远在几秒钟内结束。

Kitty 可以把复杂目标拆成清晰步骤,让耗时命令在后台运行,并在执行过程中继续接收新的引导。你看到的是一个正在推进、可以观察、可以中断、也可以继续的工作现场。

开始使用

安装 Kitty:

npm install -g @jun133/kitty@latest

进入希望 Kitty 工作的项目目录,初始化配置:

kitty init

打开 .kitty/.env,填写 provider API key,然后启动:

kitty

Kitty 会打开会话界面。你可以新建任务,也可以回到之前保存的现场。

第一次使用 Windows 命令行、不熟悉项目目录或不知道如何填写配置,可以按 小白快速启动 一步一步操作。

直接执行一次任务

kitty run "调查当前项目,找出最重要的问题,完成修改并验证结果。"

Kitty 会调查事实、判断边界、调用工具、检查结果,并把已经完成的现场保存下来。

打开 Kitty,理解智能体

如果你正在研究“如何设计一个智能体”,Kitty 的源码覆盖了从模型请求到生产生命周期的完整链路:

输入 -> Session -> Context -> Model -> Tools -> Runtime Facts -> 下一次判断

你可以从工具循环开始阅读,再进入 session、context、background execution、steer、恢复和多端交互。

常用入口

| 命令 | 用途 | | --- | --- | | kitty | 启动 Kitty | | kitty init | 初始化当前项目 | | kitty run <prompt> | 执行一次明确任务 | | kitty resume [sessionId] | 恢复最近或指定会话 | | kitty status | 查看当前运行现场 | | kitty background | 查看或控制后台执行 | | kitty telegram | 启动 Telegram 私聊服务 | | kitty --version | 查看版本 |

在 TUI 输入 / 可以查看 /status/export/exit;空输入时按 ? 可以查看键位。

支持中文、英文、日文和韩文四种语言。

继续了解

License

MIT