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

@gitton-dev/types

v0.0.17

Published

TypeScript type definitions for Gitton plugins

Downloads

1,447

Readme

Gitton

Git Client for Vibe Coding

Gitton is a Git client designed for the AI coding era. Run Claude Code, Cursor CLI, and other AI assistants directly in the integrated terminal. Features AI-powered commit message generation, code review, and PR description generation.

Gitton Working Copy

Philosophy

Gitton represents a paradigm shift in development tools for the AI era. With AI coding assistants like Claude Code, Cursor CLI, and Aider, developers spend less time in traditional editors and more time in terminals.

Terminal-First Approach - Rather than another code editor, Gitton integrates a terminal for AI instruction. Give instructions to AI in the terminal, review results and commit in a powerful Git client.

Advanced Git Features - AI-assisted development requires more sophisticated Git capabilities. Since AI generates large code blocks that may include unintended changes, you need granular version control.

GitHub-Exclusive Focus - Deep GitHub integration enables PR management, inline commenting, AI-generated PR descriptions, and automated code reviews—all within the app.

Strip unnecessary features while thoroughly refining essential ones. For the AI era, that means: powerful Git operations, terminal integration, and seamless GitHub workflows—without editor complexity.

Features

Visual History & Navigation

Gitton History

  • Intuitive Graph View - Visualize your project history with color-coded branch graphs
  • Easy Operations - Cherry-pick, revert, and reset commits with a click
  • Reflog Support - Complete operation history for easy recovery from mistakes

Branches & Reflog

Gitton Branches

GitHub Integration

Gitton Pull Requests

  • Pull Requests - Create, review, and merge PRs without leaving the app
  • AI-Generated PR Descriptions - Let AI write your PR descriptions from commit diffs
  • AI Code Review - Get intelligent feedback on your changes

Gitton AI Review

AI-Powered Workflows

  • Multi-Provider Support - OpenAI, Anthropic, Google, and Ollama
  • Conventional Commit Messages - Auto-generate meaningful commit messages
  • Security Analysis - AI-powered security scanning of your changes

Parallel Development with Worktrees

Gitton Worktrees

  • Multiple Worktrees - Work on different branches simultaneously
  • Independent Sessions - Run separate AI tool sessions in each worktree

Integrated Terminal

Gitton Terminal

  • AI Tool Ready - Claude Code, Cursor, GitHub Copilot - use any tool you like
  • Full Shell Access - Execute any command within your repository

Plugin System

Extend Gitton's functionality with plugins:

  • Add custom sidebar panels
  • Add settings tabs
  • Add context menu items
  • Register Git hooks (pre-commit, post-push, etc.)

Plugin Development

Create plugins to extend Gitton. See gitton-plugin.d.ts for TypeScript definitions.

Plugin Structure

my-gitton-plugin/
├── package.json        # Plugin manifest in "gitton" field
├── ui/
│   └── sidebar.html    # UI extension HTML
└── ...

package.json Example

{
  "name": "gitton-plugin-example",
  "version": "1.0.0",
  "gitton": {
    "displayName": "Example Plugin",
    "version": "1.0.0",
    "description": "An example plugin for Gitton",
    "permissions": ["ui:sidebar", "settings:read", "settings:write"],
    "extensionPoints": {
      "sidebar": {
        "entry": "ui/sidebar.html",
        "icon": "Puzzle",
        "position": "bottom"
      }
    }
  }
}

Plugin API

Access the gitton global object in your plugin HTML:

// Settings
const value = await gitton.settings.get('myKey');
await gitton.settings.set('myKey', { foo: 'bar' });

// Notifications
gitton.ui.showNotification('Hello!', 'info');

// Open external URL
await gitton.ui.openExternal('https://github.com');

// HTTP requests
const result = await gitton.network.fetch('https://api.example.com/data');

// GitHub CLI
const prList = await gitton.gh.run(['pr', 'list', '--json', 'number,title']);

// File system (within repo only)
const content = await gitton.fs.readFile('.gitignore');
await gitton.fs.writeFile('temp.txt', 'content');

Permissions

| Permission | Description | |------------|-------------| | ui:sidebar | Add sidebar panel | | ui:settings | Add settings tab | | ui:repositorySettings | Add repository settings tab | | ui:contextMenu | Add context menu items | | settings:read | Read plugin settings | | settings:write | Write plugin settings | | network:fetch | Make HTTP requests | | git:read | Read Git information | | git:write | Execute Git operations | | git:hooks | Register Git hooks |

Marketplace

Publish your plugin on GitHub with the gitton-plugin topic to appear in the Gitton marketplace.

Pricing

  • Free Trial - 7 days
  • Pro - $19.99 one-time purchase (no subscription)

Links

License

MIT License

Author

godai