Product help

Use the noh CLI with an AI agent

Let an AI agent in Claude Code or Codex CLI read the memory you use and return what the conversation learns to the same noh.

This Help covers the latest version of nohmitaina.

One memory, used in both directions

The noh CLI gives an LLM agent access to the same memory that appears in the desktop app. The agent can begin with Core, use relevant noh while working, and leave new learning as a note. The next Dream can distill that note into noh, so the human and the agent improve one shared memory instead of maintaining separate context.

  1. Enable the noh CLI in Settings.
  2. Install the bundled skill for Claude Code or Codex CLI.
  3. Start the agent and ask it to read Core before the conversation.
  4. Ask the agent to save durable learning with noh put.
  5. Keep nohmitaina running for the next scheduled Dream, which can extract and organize new noh.
A noh detail that both the app and an LLM agent can read
The desktop app and the agent work with the same noh.

Enable the noh CLI

Open Settings and choose Enable CLI. nohmitaina installs its bundled CLI and configures the PATH entry for Bash and Zsh. Open a new terminal afterward. For another shell, add the bin directory shown in Settings to that shell’s PATH manually.

The noh CLI settings showing Enabled, ready commands, and PATH configuration
Enabled, noh: Ready, nohls: Ready, and a configured shell PATH mean the CLI is ready for a new terminal.

Know which command to use

The installed Skill can choose these commands for an AI agent. This table is also useful when you want to run one directly.

Common noh CLI commands
CommandWhat it does
nohOpen the CLI, run a subcommand, or show help.
nohlsRun noh ls through its compact alias.
noh coreLoad the frequently used Concepts in Core.
noh recallFind memory related to the supplied text.
noh lsList Concepts, notes, web clips, or notes saved by noh CLI.
noh catRead one Concept, note, or note saved by noh CLI.
noh linkList relationships around a Concept.
noh treeShow Concept relationships as a tree.
noh scoreShow the score of a Concept.
noh putSave durable learning as a note written through noh CLI.
noh rmRemove a keyed note saved by noh CLI.
noh skill installInstall the bundled agent Skill.

See full command forms in the feature reference

Dream is not a CLI command. It runs in the app and distills pending notes from noh put into Concepts at the scheduled time.

Install the agent skill

Install the bundled skill once for the agent you use. The skill teaches the agent when to read noh and how to return useful learning without requiring the command syntax in every prompt.

# Codex CLI
noh skill install codex

# Claude Code
noh skill install claude-code

Start Claude Code or Codex CLI

Open a new terminal in the project where you want to work, then start the agent normally. A new terminal is necessary after PATH configuration so the shell can find noh.

# Claude Code
claude

# Codex CLI
codex

If the agent does not recognize noh, confirm noh --help in the same terminal and restart the agent after the skill is installed.

Read, talk, and write back

Begin with a direct request. The skill can translate the intent into noh core and noh put, so the conversation can stay focused on the work rather than CLI mechanics.

Read my Core from noh, then use it as context for this conversation.

When we finish, save the decisions and durable learning back to noh with noh put. Include references to the noh we used.

For example, the agent can read Core before a design discussion, keep the agreed constraint as a note, and cite related noh. The note is available immediately. While nohmitaina is running, the next scheduled Dream processes pending notes, extracts Concepts, removes overlap, recalculates scores, and keeps noh organized.

A terminal reading Core with noh core and saving a shared decision with noh put
The agent reads shared context with noh core and returns durable learning with noh put.
Dream schedule controls in Settings
Choose a Dream time when the computer and nohmitaina are usually running.
A noh detail showing the Concept body after processing
After Dream organizes the note, the resulting Concept and its body are available to both the app and the AI agent.