convez.ai
AgenteDesenvolvimento WebAvançado
Yeshwanthyk

Kiri

Yeshwanthyk/kiri

Controle local de agentes IA com navegação por teclado e workflows duravelmente organizados

Ver no GitHub
InicialPluginScore · de 0 a 100

Plano de controle local orientado por teclado para agentes de IA de codificação (Claude Code, Codex, Pi, OpenCode). Organiza sessões de desenvolvimento em lanes de projeto com terminais persistentes, timeline de chat, scratchpad e execução de workflows automáticos via CLI/MCP.

Instalação

$npx convez-ai Yeshwanthyk/kiri

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
v0.1.14
Issues abertas
0
Contribuidores
1

Casos de uso

  • Organizar múltiplos projetos de desenvolvimento local com sessões de IA paralelas
  • Automatizar workflows de codificação com planos divididos em itens lançáveis
  • Gerenciar terminais persistentes e histórico de chat para cada sessão de agente

Veredito

Ferramenta especializada para desenvolvedores que usam agentes IA locais em fluxos de trabalho complexos. Exige familiaridade com CLI/MCP e oferece ganho real em organização e automação, mas tem curva de aprendizado acentuada e suporte limitado (macOS Apple Silicon).

README

A tradução para o português deste README ainda está na fila.

kiri

Keyboard-first local agent control plane for Codex, Claude Code, Pi, and OpenCode.

Kiri keeps local AI coding sessions organized by project, with persistent terminal panes, chat timelines, scratchpad, workflow runs, and compact CLI/MCP controls.

Website: https://kiri-8zk.pages.dev

Download

The latest macOS Apple Silicon build is published on GitHub Releases:

https://github.com/Yeshwanthyk/kiri/releases

Features

  • Project lanes for grouping local repos and sessions.
  • Keyboard-first navigation for switching projects, tabs, and sessions.
  • Runtime sessions for Codex, Claude Code, Pi, OpenCode, and shell terminals.
  • Persistent terminal panes backed by Kiri-owned PTYs.
  • Chat timeline, terminal, and scratchpad views for each session.
  • Durable workflow runs for splitting a plan into launchable items.
  • Agent-first CLI and MCP operations for automation.

Development

pnpm install
pnpm dev

The dev and desktop servers use port 3090.

Verification

pnpm verify

Focused gates:

pnpm typecheck
pnpm lint
pnpm effect:audit
pnpm test
pnpm verify:e2e
pnpm verify:desktop

Desktop Build

pnpm install:desktop

This builds the web/server bundles, packages the macOS app, creates the DMG, replaces ~/Applications/kiri.app, and opens the installed app.

CLI

pnpm kiri:ctl call '{"operation":"project.list","params":{"includeHidden":true}}'
pnpm kiri:ctl call '{"operation":"project.add","params":{"name":"Project Name","cwd":"/absolute/path","id":"project-id"}}'
pnpm kiri:ctl call '{"operation":"project.hide","params":{"id":"project-id"}}'
pnpm kiri:ctl call '{"operation":"project.unhide","params":{"id":"project-id"}}'
pnpm kiri:ctl call '{"operation":"project.delete","params":{"id":"project-id"}}'

Project deletion removes Kiri metadata only. It does not delete the project working directory.

Workflows

pnpm kiri:ctl call '{"operation":"workflow.create","params":{"projectId":"kiri","title":"Parallel plan","defaults":{"runtime":"pi","model":"openai-codex/gpt-5.5","attachScratchpad":true},"items":[{"id":"impl","action":"launch","title":"Implement","body":"Implement the accepted plan"},{"id":"review","action":"launch","title":"Review","body":"Review the implementation"},{"id":"notes","action":"scratchpad","title":"Notes","body":"Track this note without launching a session"}]}}'
pnpm kiri:ctl call '{"operation":"workflow.dispatch","params":{"id":"workflow-id"}}'
pnpm kiri:ctl call '{"operation":"workflow.show","params":{"id":"workflow-id"}}'
pnpm kiri:ctl call '{"operation":"workflow.archive","params":{"id":"workflow-id"}}'

When the desktop backend is running, workflow dispatch opens Kiri-owned runtime terminals and pastes each launch item into the PTY. If the backend is not reachable, launch text stays queued until Kiri opens that terminal.

State

Kiri stores its local read model under ~/.kiri/userdata/kiri.sqlite by default. Runtime model lists live in settings.json.

Ver o original no GitHub

Bom para

Relacionados