chetana

Manages staged knowledge atoms, decay revival, gap scans, and memory palace rendering for a personal knowledge system.

1|3|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/AIKAGRYA/dharma_swarm --skill chetana-aikagrya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chetana
Source: https://github.com/AIKAGRYA/dharma_swarm/tree/main/dharma_swarm/chetana/claude_code_plugin/chetana/skills/chetana
Command: npx skills add https://github.com/AIKAGRYA/dharma_swarm --skill chetana-aikagrya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It connects five distributed knowledge substrates into one operational personal knowledge management system, so captured sessions, ingested documents, and wiki atoms stay organized, fresh, and governed instead of decaying into an unmaintained pile of notes. ## Core Features & Use Cases - Session capture and ingestion: Automatically captures finished sessions into staged atoms and ingests PDFs, web clips, and notes via chetana ingest. - Decay and revival management: Scans for stale atoms with chetana decay, proposes revivals with chetana revive, and routes promotions through governance gates. - Gap analysis and memory palace: Surfaces missing knowledge with chetana gap-scan and renders the 10 Pillars memory palace with chetana palace. - Use Case: After a week of research sessions, ask what is stale in your wiki, review the proposed revivals, then promote only the atoms you trust into the governed knowledge base. ## Quick Start Ask the assistant to run chetana status to show the current state of your knowledge system, including staged atoms, stale entries, and recent captures.

Frequently Asked Questions about chetana

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest a PDF or web clip into my knowledge base?▼

Run chetana ingest with the source path and a kind flag such as pdf, webclip, or note. The content is written as a staged atom under ~/.dharma/knowledge/staging/<date>/ and is not trusted until you explicitly promote it.

How do I find and fix stale notes in my wiki?▼

Run chetana decay to list atoms past their stale_after threshold, then chetana revive --all to generate revival proposals. Revival re-scans the corpus for new neighbors and backlinks, and only applies changes after your explicit confirmation with --apply.

What is the difference between staged and trusted atoms?▼

Staged atoms are unreviewed captures written by ingestion and session hooks, while trusted atoms live in ~/.dharma/knowledge/wiki/concepts/ after passing governance gates. Promotion from staged to trusted always requires explicit user approval.

Why did the chetana command fail to run?▼

The most common cause is that no Python interpreter can import dharma_swarm.chetana. Try the dev worktree venv, the repo .venv, or python3 with the repo on PYTHONPATH, and if none work install with pip install -e ".[mcp,dev]".

When should I not use chetana for a task?▼

Avoid chetana for general Python scripting, current in-flight chat history, or touching the dharma_swarm runtime daemon and gates. It only handles memory operations, and captures happen on session Stop, not mid-session.