mrkeyoor.com_
Tue 01 Sept 17:42 UTC
Automationevaluationupdated 26 Aug 2026

nippo review

Nippo is a Japanese-language Rust tool and skill that turns local Claude Code and Codex session histories into daily work reports, reflection prompts, progress summaries, and trend views. The repository has no English README or English documentation set. It separates mechanical collection from the written interpretation performed by the coding agent.

+30stars / 7d
Verdict

Our Nippo run installed 55 packages and passed all 106 tests after a 44-second build, making it an easy trial for Japanese-speaking Claude Code or Codex users. Its best decision is leaving reflection answers to the person instead of manufacturing a lesson from logs. Avoid using its focus figures for time accounting until issue 23 is fixed, and expect to work from Japanese documentation.

We ran it

Lab card: what happened when we ran nippoScreenshot of nippo (crates.io/crates/nippo)
Install✓ · 16s55 packages
Build✓ · 44s
Tests✓ · 25s106 passed · 0 failed of 106 (cargo test)
Repo33 files~5,104 lines of source · 0.3 MB · 1 CI workflows

Answers from our run

Does nippo build from source?

Dependencies installed in 16 seconds (55 packages), and the build succeeded in 44 seconds. We cloned commit b23b807 into a clean Debian container with 3 CPUs and no project-specific setup.

Do nippo's tests pass?

Yes: 106 of 106 passed when we ran the project's own test command (cargo test). Some failures need services or credentials a bare container does not have.

Who should not use nippo?

English-only teams: the README, templates, skill instructions, and user-facing examples are Japanese, with no English documentation found in the repository tree.

What are the alternatives to nippo?

ccusage, Token Monitor. Our Nippo run installed 55 packages and passed all 106 tests after a 44-second build, making it an easy trial for Japanese-speaking Claude Code or Codex users.

Setup4/516-second install and 106 passing tests; skill setup is separate
Docs3/5Detailed Japanese guide, but no English documentation set
Community2/5134 stars and a small active issue queue
Maturity3/5Clean tests at v0.1.6, with Windows and focus bugs open

Who it’s for

Japanese-speaking Claude Code or Codex users who want a daily report from local session logs.
Developers who prefer human-written reflection answers while delegating activity collection and question generation.
People willing to inspect local JSON or summaries before an agent writes reports into the current project's reports directory.
Rust users who want a small collector they can run without invoking the installed skill.

Who it’s NOT for

English-only teams: the README, templates, skill instructions, and user-facing examples are Japanese, with no English documentation found in the repository tree.
Native PowerShell or cmd users expecting v0.1.6 to find their profile automatically: issue 20 says the tool requires HOME, which those shells may not set.
Anyone treating focus duration as timesheet evidence: issue 23 shows a long-open session merging idle hours into a reported 927-minute focus block.
Users of OpenCode or other agents as a primary source: current collection is for Claude Code and Codex, while OpenCode history is only an open proposal.
Teams expecting skill files to update with the binary: the README requires rerunning nippo skill install --force after an embedded installation upgrade.

Setup reality

Our sandbox installed 55 Rust packages in 16 seconds. The build succeeded in 44 seconds, and cargo test finished in 25 seconds with 106 passed and 0 failed out of 106. The checkout was 0.3 MB with 33 files and about 5,104 source lines.

Use requires Rust 1.85 or newer plus Claude Code or Codex. cargo install nippo installs the binary, then nippo skill install writes skills into the Claude and Codex directories. It reads local session histories and writes Markdown under the current project's reports folder.

Scheduled reports must run locally while the relevant desktop application and computer are awake. Reports are gitignored by default, but they still contain work-history data on disk. Native Windows shells have an open home-directory bug, and embedded skill upgrades need a separate forced reinstall.

Japanese reports cover daily work through 90-day trends

Nippo reads Claude Code and Codex histories, normalizes sessions in Rust, and asks the installed skill to write a Japanese report. The default daily view lists work, decisions, terminology, messages, and tool use. Other modes produce a short brief, reflection questions, a plan, a learning guide, a 7-day progress report, a 90-day self-review, or longer trend analysis. The repository does not include an English README or parallel English templates.

The design draws a useful line around automation. Rust collects dates, projects, session counts, messages, tools, and decision candidates. The skill handles prose and uses the templates in docs/templates. Reflection mode writes questions with blank answer spaces instead of composing answers for the user. Nippo therefore saves the clerical work of reconstructing a day while leaving the uncomfortable part, explaining why a choice was made and what should change, to the developer.

A 0.3 MB checkout passed all 106 tests

Our fresh Rust container installed 55 packages in 16 seconds. The repository contained 33 files, about 5,104 source lines, and occupied 0.3 MB before dependencies. The build succeeded in 44 seconds. That is a pleasantly small codebase compared with the agent histories it parses. Our scan found 1 CI workflow file, no Dockerfile, and no top-level tests directory. Rust tests can live beside source, so the missing directory is not evidence of missing tests.

Cargo test completed in 25 seconds with 106 passed and 0 failed out of 106. Those results cover commit b23b807 on 3 CPUs and 12 GB of RAM in an unprivileged container. We did not feed the collector a copy of a real personal Claude Code or Codex history, ask an agent to write a report, or judge whether its prose matched a working day. The measurement establishes install, compilation, and test health rather than summary quality.

What happened when we ran it

Our whole install, build, and test sequence took 85 seconds. Every measured step succeeded, and the test command returned a clean result. Nippo had no dependency-audit number in the supplied lab block, so we make no vulnerability claim. It also had no Dockerfile, which is unsurprising for a local Rust command installed through Cargo. Users should still review which session files it reads because those histories can contain prompts, tool calls, project names, and operational details.

The CLI can emit JSON or a compact text summary without calling an agent. It merges records sharing one session ID, removes duplicate prompts, and excludes the currently active session when the host provides an exact ID. Default filtering drops skill expansion, harness notices, image placeholders, interruption messages, compact introductions, and short acknowledgements. Flags can restore that material for debugging. These filters reduce noise, though they also define what the eventual report can see.

Focus time can become a 927-minute false block

Issue 23 shows a collector error in work-window statistics. A Claude Code session left open from early morning to evening can be treated as one continuous interval, even when the user was idle for hours. In the reporter's example, 29 sessions across 23 projects became 1 focus block lasting 927 minutes. The proposed fix divides focus blocks from individual message timestamps while preserving the existing project-switch calculation.

That defect does not erase the session list or written report. It does make the numeric focus result unsuitable for time sheets, billing, or productivity scoring. Nippo's own philosophy argues for restraint here: session timestamps show when records were written, not continuous human attention. Until the event-based correction lands and is tested, omit the longest-focus figure from reports shown to managers or clients. Use it only as a prompt to inspect the underlying day.

Windows v0.1.6 needs HOME even when USERPROFILE exists

Issue 20 reports that nippo v0.1.6 reads only the HOME environment variable to locate skill and session directories. Git Bash sets it, while native PowerShell and cmd often rely on USERPROFILE. On the reported Windows 11 setup, skill installation failed and collection looked under the filesystem root. Manually setting HOME to USERPROFILE worked around the problem. That is a first-run failure for a supported Codex or Claude user in a common shell.

Installation also has a versioning wrinkle. cargo install nippo updates the binary, then nippo skill install writes embedded skill and template files. A later binary upgrade does not refresh those files automatically; users must rerun the skill installer with --force. A repository checkout can instead install symbolic links so updates appear immediately. Windows packaging requires care because checkout symlinks may become ordinary files when the environment does not preserve them.

Version 0.1.6 is active, narrow, and still settling

Release v0.1.6 shipped on August 24, 2026. It added prompt-noise filtering, split-session merging, active-session exclusion, deterministic local-time helpers, and period metadata. GitHub showed 134 stars, 5 combined open issues and pull requests, and a last push on August 24. Issue 24 asks the skills to accept yesterday and other period words already supported by the CLI, while issue 22 proposes OpenCode as another source.

Nippo is easiest to recommend when its limits match the user: Japanese output, local Claude Code or Codex history, personal reflection, and reports that stay in the project directory. Our 106-test pass makes that path inexpensive to try. The small community and v0.1.6 label call for cautious expectations. Check the collected JSON, keep private reports out of version control, and treat automated statistics as clues about work rather than proof of effort.

Alternatives

ProjectWhat it isPick it when
ccusageA command-line viewer for Claude Code and Codex token usage and cost records.pick this instead when numerical usage and cost reporting matters more than a written Japanese work journal.
Token Monitor gh↗A desktop dashboard for usage, cost, limits, and multi-device history across many coding agents.pick this instead when a graphical multi-tool dashboard is more useful than daily reflection and progress documents.

What people are saying

  1. [github-trending] nwiizo/nippo

Sources

  1. Nippo repository and Japanese README
  2. Nippo v0.1.6 release
  3. Windows HOME issue
  4. Focus block calculation issue
  5. Skill period selector proposal

More automation reviews

rclone · lego · OpenCLI · web-access · Karabiner-Elements · WiiUDownloader · the whole board →