LOCAL-FIRST · MIT · RUST/BUN

Coding agent
chạy trên máy bạn. A coding agent
that runs on your machine.

Kiwii là harness cho AI coding agent trong terminal và trình duyệt, ngang Claude Code và Codex CLI về tính năng. Nó không gọi về bất kỳ máy chủ nào ngoài nhà cung cấp mô hình bạn tự chọn. Kiwii is a coding-agent harness for your terminal and browser, on par with Claude Code and Codex CLI. It talks to nothing but the model provider you configure.

curl -fsSL https://raw.githubusercontent.com/dannyluutpt/Code-Harness/main/install | bash

Hoặc tải binary ở Releases rồi đặt vào PATH. Or grab a binary from Releases and put it on your PATH.

kiwii - ~/du-an acceptEdits 

          

        

      


      

        

          
          
Không có máy chủ ở giữaNo server in the middle

          

            Phiên, lịch sử và mã nguồn nằm trên máy bạn. Kiwii chỉ kết nối tới provider bạn khai báo.
            Sessions, history and your code stay on your machine. Kiwii only reaches the provider you configure.
          

        

        

          
          
Mở dự án cũ là chạyOpen an existing project and go

          

            Đọc thẳng CLAUDE.md, .claude/settings.json, commands, agents, skills sẵn có.
            Reads your existing CLAUDE.md, .claude/settings.json, commands, agents and skills as-is.
          

        

        

          
          
Một binary duy nhấtOne single binary

          

            Không cần Node, không cây phụ thuộc. Tải về, đặt vào PATH, chạy.
            No Node, no dependency tree. Download it, put it on your PATH, run it.
          

        

      


      

        

          01
          
Có gì bên trongWhat is in the box

        


        

          

            
Hai giao diện, một lõiTwo interfaces, one core

            

              TUI trong terminal (kiwii) và Web UI chạy localhost (kiwii web). Cùng một engine, cùng phiên.
              A terminal TUI (kiwii) and a localhost web UI (kiwii web). Same engine, same sessions.
            

            

              TUIWeb UIlocalhost
            

          


          

            
Chạy không tương tácHeadless

            

              Dùng được trong script và CI.
              Built for scripts and CI.
            

            
kiwii run "…" \
  --format json \
  --continue

          


          

            
Providers

            

              Anthropic, OpenAI (API key hoặc ChatGPT Plus/Pro), Google Gemini, OpenRouter, Ollama tự phát hiện, mọi endpoint OpenAI-compatible, và hơn 150 provider từ models.dev.
              Anthropic, OpenAI (API key or ChatGPT Plus/Pro login), Google Gemini, OpenRouter, auto-detected Ollama, any OpenAI-compatible endpoint, and 150+ providers from models.dev.
            

          


          

            
Hooks

            

              Chạy lệnh shell tại các điểm móc vòng đời phiên và tool.
              Run shell commands at session and tool lifecycle points.
            

            
    
              
  • PreToolUse
    • 
              
  • PostToolUse
    • 
              
  • UserPromptSubmit
    • 
              
  • SessionStart
    • 
              
  • SessionEnd
    • 
              
  • PreCompact
    • 
              
  • PermissionRequest
    • 
              
  • Notification
    • 
              
  • Stop
    • 
            

          


          

            
Ngữ cảnhContext

            

              KIWII.md (đọc cả AGENTS.md và CLAUDE.md), bộ nhớ dài hạn tự động theo dự án, tự nén ngữ cảnh, tiếp tục phiên cũ.
              KIWII.md (it also reads AGENTS.md and CLAUDE.md), automatic per-project long-term memory, auto-compaction, session resume.
            

          


          

            
Mở rộngExtensibility

            

              MCP client (stdio/HTTP, OAuth), skills SKILL.md (đọc cả ~/.claude/skills), slash command bằng Markdown, agent con tuỳ chỉnh, plugin.
              MCP client (stdio/HTTP with OAuth), SKILL.md skills (including ~/.claude/skills), Markdown slash commands, custom subagents, plugins.
            

          


          

            
Tools

            

              Bộ tool đầy đủ, kèm slash command cho git.
              A full tool set, plus slash commands for git.
            

            

              readwriteeditbashglobgrepwebsearchwebfetchLSPimagestodo/commit/pr/review/init
            

          

        

      


      

        

          02
          
Bạn quyết định agent được làm gìYou decide what the agent may do

        

        

          Năm chế độ quyền, đổi bằng Shift+Tab ngay giữa phiên. Khung nhập đổi màu theo chế độ đang bật, nên bạn luôn biết mình đang ở đâu trước khi gõ Enter.
          Five permission modes, cycled with Shift+Tab mid-session. The prompt box takes the colour of the active mode, so you always know where you stand before pressing Enter.
        


        

          

            
            
            
            
            
          


          

            

              ›
              sửa lỗi ở module thanh toánfix the bug in the billing module
              
            

            

              

                
Hỏi trước mỗi bướcAsk before every step

                
Hỏi bạn trước mỗi thao tác ghi file và mỗi lệnh shell.Asks before every file write and every shell command.

              

              
              
              
              
            

          

        


        

          Ngoài ra còn allow/deny list theo mẫu: 
          Plus allow and deny lists by pattern: 
          Bash(git *), Edit(src/**), Read(.env).
        

      


      

        

          03
          
Bắt đầu trong một phútRunning in a minute

        

        
    
          
  1. 
            
    Đăng nhập providerSign in to a provider
    
            
    export ANTHROPIC_API_KEY=sk-...
# hoặc / or
kiwii auth login
    
          
    2. 
          
  2. 
            
    Mở dự ánOpen your project
    
            
    cd du-an-cua-ban
kiwii            # TUI
kiwii web        # Web UI
    
          
    3. 
          
  3. 
            
    Hoặc chạy thẳngOr run it headless
    
            
    kiwii run "viết test cho parser"
kiwii run "…" --format json
kiwii -c         # tiếp tục / continue
    
          
    4. 
        

        

          Gõ /init trong phiên đầu tiên để Kiwii tự viết KIWII.md cho dự án.
          Run /init in your first session and Kiwii writes a KIWII.md for the project.
        

      


      

        

          04
          
Đang dùng Claude Code?Coming from Claude Code?

        

        

          Không phải học lại. Kiwii giữ nguyên tên lệnh, phím tắt và định dạng file cấu hình bạn đã quen.
          Nothing to relearn. Kiwii keeps the command names, keys and config files you already use.
        

        
      


      

        

          05
          
Tài liệuDocumentation

        

        

          
            Cài đặtInstall
            Script, binary, build từ nguồnScripts, binaries, build from source
          
          
            CLI
            Lệnh, cờ, phím tắt, slash commandCommands, flags, keys, slash commands
          
          
            Cấu hìnhConfiguration
            kiwii.json và thứ tự gộpkiwii.json and the merge order
          
          
            QuyềnPermissions
            Chế độ, allow/deny, mẫuModes, allow and deny, patterns
          
          
            Hooks
            Chín điểm móc, payload, exit codeNine hook points, payloads, exit codes
          
          
            MCP
            Server stdio và HTTP, OAuthstdio and HTTP servers, OAuth
          
          
            Skills & lệnhSkills & commands
            SKILL.md và slash commandSKILL.md and slash commands
          
          
            ProviderProviders
            Đăng nhập, model, endpoint riêngAuth, models, custom endpoints
          
        

      


      

        
Cài trong một dòngOne line to install

        

          curl -fsSL https://raw.githubusercontent.com/dannyluutpt/Code-Harness/main/install | bash
          
        

        

          Miễn phí, mã nguồn mở MIT.
          Free, MIT open source.