convez.ai
AgenteAutomaçãoIntermediário
Marinerer

Nami — Agent CLI para Desenvolvimento

Marinerer/Nami

Agent CLI local para refatoração, debug e documentação de código no terminal

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent de IA local que roda no terminal para tarefas de desenvolvimento: entendimento de projeto, busca de bugs, refatoração, geração de testes e documentação. Integra-se com Anthropic/OpenAI e mantém memória persistente do contexto do projeto.

Instalação

$npx convez-ai Marinerer/Nami

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
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Entender estrutura e padrões de projetos existentes
  • Identificar e corrigir bugs de forma autônoma
  • Refatorar código com segurança e aprovação do usuário
  • Gerar testes automatizados para cobertura
  • Documentar projetos gerando Wiki automática

Veredito

Ferramenta sólida que traz capacidades de agent IA para o workflow CLI do desenvolvedor, com ciclo ReAct/Plan robusto e segurança integrada via aprovação de operações. Bem estruturada para projetos TypeScript/Node.js, com memória de contexto que melhora ao longo do uso.

README

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

nami

一个 AI Agent CLI 工具 —— 在终端中完成项目理解、自主查 BUG、代码重构、测试生成、Wiki 生成等开发任务。

Node.js TypeScript License


Why

Nami 将 AI 能力无缝嵌入日常 CLI 工作流,你无需离开终端、粘贴代码到 Web 界面,一切在本地项目目录内完成:

  • 🤖 Agent 自主循环 —— 自动感知上下文 → 规划步骤 → 执行工具 → 反思调整
  • 🔧 安全工具调用 —— 文件读写、代码搜索、Shell 命令,危险操作需用户审批
  • 🧠 记忆持久化 —— 记住项目偏好、历史错误、常用模式,越用越聪明
  • 📂 项目上下文理解 —— 自动构建项目快照(目录树、AST 符号、Git 状态)
  • 🔌 多模型适配 —— 统一接口支持 Anthropic / OpenAI,自由切换
  • 🖥 交互式 TUI —— 基于 Ink(React for CLI)的多轮对话,流式输出,实时观察推理过程

Quick Start

环境要求

  • Node.js >= 22

安装

npm install -g nami-cli

开始使用

# 进入项目目录
cd /path/to/your/project

# 启动交互式对话
nami

# 代码解释
nami explain src/app.ts

# 自主查 BUG
nami bug "用户登录后页面白屏"

# 代码重构
nami refactor "将数据库查询改为异步模式"

# 生成测试
nami test src/utils/helper.ts

# 自动生成项目 Wiki
nami wiki

Working Modes

Nami 有两条执行路径,自动根据输入复杂度路由:

模式入口流程适用场景
Chat 模式快速通道记忆召回 → ReAct 循环 → 记忆保存简单问答、单步操作
Plan 模式自主引擎规划 → 审批 → 分波执行 → 反思多步骤任务、复杂重构
用户输入 → classifyIntent
            ├── Chat  → AgentLoop (快速)
            └── Plan  → AgentEngine (自主)
                          ├── Planner  → 生成计划
                          ├── Executor → 分波并发执行
                          └── Reflector → 反思决策

Configuration

Nami 支持多级配置,优先级从高到低:

  1. 环境变量: NAMI_PROVIDER, NAMI_BASE_URL, NAMI_API_KEY, NAMI_MODEL
  2. 项目级: ./.nami/config.json
  3. 全局级: ~/.nami/config.json
{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "maxIterations": 10,
  "tools": {
    "execute": { "enabled": true, "requireApproval": true }
  }
}

License

MIT

Ver o original no GitHub

Bom para

Relacionados