What It Is

zencefyl is a terminal AI companion that does more than answer prompts.

It can:

• remember what happened in the same workspace across sessions
• track what you know, where you struggle, and what is due for review
• generate serious study guides, reports, and LaTeX/PDF documents
• switch between multiple providers and local/hosted model paths
• keep the interface interactive instead of dumping walls of flat text

And yes, the duck is part of the product. It is the repo mascot and the terminal omen.

Why It Feels Different

Most CLI agents are good at “answer and act.”

zencefyl is trying to be better at:

• continuity
• learning
• document output
• interactive terminal UX
• being useful in the same repo over time

That means the product is shaped around:

• workspace memory
• knowledge graph + review
• project recap and resume
• approval flows
• guided panels
• exportable artifacts

Install

npm

npm install -g zencefyl
zencefyl

From source

git clone https://github.com/bartugundogdu/zencefyl
cd zencefyl
pnpm install
pnpm build
pnpm link --global
zencefyl

If pnpm link --global fails because the global bin directory is missing, run:

pnpm setup

then reload your shell and retry.

Core Features

Workspace continuity

• remembers recent work in the same directory
• startup recap for known workspaces
• /resume and /timeline for picking up where you left off
• project-first memory retrieval instead of global memory noise

Knowledge tracking

• evidence-backed knowledge graph
• mastery separated from raw retrievability
• due-topic review with FSRS
• gaps, corrections, and profile memory

Document studio

• study guides
• reports
• textbooks
• revision-aware rebuilds
• LaTeX-first PDF generation

Interactive terminal UX

• structured panels instead of flat dumps
• expandable long outputs with Ctrl+O
• model/provider browser
• approval prompts with keyboard navigation
• duck companion in the corner

Providers

zencefyl supports multiple model paths, including:

• Claude Code
• Anthropic API
• OpenAI subscription/API paths
• Gemini subscription
• Hugging Face browsing/inference flows
• Ollama
• local Transformers.js

The /model panel is the control center for switching and browsing.

Commands

The command surface is intentionally being kept smaller and stronger over time.

Current core commands include:

• /help
• /model
• /settings
• /resume
• /timeline
• /review
• /knowledge
• /gaps
• /profile
• /corrections
• /export
• /save
• /forget
• /prune
• /doctor
• /remap

Example Uses

can you fix the failing build in this repo?

make me a deep study guide on stationary systolic array types and export it to pdf

what were we doing in this workspace last time?

review my recent corrections and tell me what patterns you see

Product Direction

The project is actively pushing toward:

• stronger repo understanding
• better diff/review UX
• better workspace memory
• richer panels and terminal interaction
• higher-quality document output

The goal is not to become another generic coding CLI.

The goal is to become a real personal engineering companion.

Notes

• Node.js 18+ is required.
• The tool does not need to auto-start after install. Run zencefyl explicitly.
• If a capability requires system setup, zencefyl should guide that honestly instead of pretending it already exists.

Repo

• Source: src/
• Internal reports and development notes: docs/internal/
• Private/internal docs are intentionally kept separate from public repo-facing docs.