Overview
NOX is an AI learning companion inside Obsidian. I built the plugin around an agent-independent learning workflow rather than a model-specific chat surface: read the current note, ask a question, practice retrieval, inspect progress, or propose an edit without leaving the editor.
Core extraction and runtime boundary
The repository now includes an independently packaged @nox/core workspace with explicit core/build/host checks. Obsidian remains the shipped application host, while extracting learning state and decision logic reduces reliance on Obsidian APIs. A separately tested browser or desktop product should not be inferred from package extraction alone.
The UI talks to one normalized agent interface. The existing adapters support AGY CLI, local Codex CLI, and a ChatGPT-plan integration. Model selection and inference transport remain adapter concerns; note permissions and learning state remain application concerns.
For the ChatGPT integration, OAuth Authorization Code + PKCE handles consent, and streaming uses a desktop Node HTTPS transport. Live authorization and stream behavior still require testing in a real Obsidian installation; mocked CI tests are not production-provider proof.
Context and research
Ordinary turns use a bounded, relevance-directed context envelope rather than uploading an entire vault or unbounded chat history. Research is opt-in: local Markdown is searched with lexical ranking and adjacent wikilink context, and the retrieved excerpts carry note-path evidence.
This retrieval is local, not a web search or a semantic knowledge graph. Source restrictions apply to both retrieval and graph traversal.
Learning without invented mastery
Goal-based programs represent learning objectives as a prerequisite graph. The application validates generated plans, chooses due reviews or remediation before new exercises, and persists learning evidence in the vault.
A generated answer does not prove knowledge. Hint-assisted responses cannot count as unassisted mastery. Active-study time is also separated from agent waiting time; both are explicit heuristics that require field validation.
Note editing and recovery
NOX previews proposed Markdown changes and applies them only after approval through Obsidian APIs. It preserves session history and can recover an unanswered practice item with its original context after reopening a conversation.
Result and limits
NOX brings context-aware explanations, practice, review, and safe edits together in the same knowledge workspace. Runtime compatibility, latency improvements, and educational effectiveness need measurement on real desktop installations; no retention or speedup claim is implied.
Gambaran umum
NOX adalah asisten belajar AI di Obsidian. Plugin ini memakai catatan aktif sebagai konteks eksplisit untuk menjelaskan materi, latihan retrieval, review, dan usulan perubahan Markdown. Saya membangun antarmuka sidebar, kontrak agent, serta logika dan penyimpanan belajar.
Batas agent dan konteks
UI tidak bergantung pada satu provider: adapter AGY CLI, Codex CLI, dan ChatGPT memakai antarmuka normalized. Setiap turn menggunakan konteks terbatas; riset Markdown lokal dilakukan hanya saat diminta, menggunakan pencarian lexical dan hubungan wikilink sebagai petunjuk, bukan fakta yang sudah terverifikasi.
Bukti belajar dan izin edit
Tujuan belajar disimpan sebagai graph prasyarat, sementara evidence hasil latihan tersimpan di vault. Petunjuk tidak dihitung sebagai jawaban mandiri. Perubahan Markdown ditampilkan terlebih dahulu dan hanya diterapkan setelah approval pengguna melalui API Obsidian.
Hasil dan batasan
NOX menyatukan percakapan kontekstual, latihan, review, dan edit catatan terkendali. Validasi login provider, streaming pada desktop, peningkatan latensi, dan efektivitas belajar masih membutuhkan uji pengguna nyata; tes mock tidak membuktikan semuanya.
Resumen
NOX es un asistente de aprendizaje con IA en Obsidian. Usa la nota activa como contexto para explicar conceptos, practicar recuperación, revisar temas y proponer cambios de Markdown. Construí la interfaz lateral, el contrato de agentes y la persistencia del progreso.
Proveedores y contexto
La interfaz no depende de un proveedor: AGY CLI, Codex CLI y ChatGPT usan adaptadores normalizados. Cada turno recibe contexto acotado; la investigación local busca Markdown y vínculos entre notas solo bajo petición. Un wikilink es contexto documental, no evidencia de una relación causal.
Evidencia y autorización
Los objetivos se organizan mediante prerrequisitos verificables; las respuestas y evaluaciones se guardan en el vault. Las pistas no sirven para demostrar dominio independiente. Toda edición de Markdown se muestra antes y necesita aprobación mediante las API de Obsidian.
Resultado y límites
NOX integra conversación contextual, práctica, revisión y cambios controlados. OAuth, streaming real de escritorio, velocidad y eficacia educativa necesitan pruebas en el entorno final; CI con mocks no demuestra esos resultados.
Présentation
NOX est un assistant d’apprentissage IA pour Obsidian. Il exploite la note active afin d’expliquer, d’interroger, de réviser et de proposer des changements Markdown. J’ai conçu la barre latérale, l’abstraction des agents et la persistance de la progression.
Fournisseurs et contexte
L’interface ne dépend pas d’un fournisseur particulier : AGY CLI, Codex CLI et ChatGPT utilisent des adaptateurs normalisés. Chaque requête reçoit un contexte borné. La recherche locale de Markdown et de wikilinks est déclenchée explicitement; un lien entre notes n’est pas une preuve factuelle.
Preuves et autorisation
Les objectifs d’apprentissage suivent un graphe de prérequis et les réponses évaluées restent dans le vault. Une réponse aidée par un indice ne démontre pas une maîtrise autonome. Les modifications Markdown sont prévisualisées puis appliquées uniquement après accord dans Obsidian.
Résultats et limites
NOX rassemble conversation contextualisée, pratique, révision et modification sûre. La connexion OAuth, le streaming desktop, la latence et les bénéfices pédagogiques exigent encore des essais réels; les tests simulés ne les valident pas.
Überblick
NOX ist ein KI-Lernbegleiter für Obsidian. Die aktive Notiz liefert den expliziten Kontext für Erklärungen, Abrufübungen, Wiederholungen und vorgeschlagene Markdown-Änderungen. Ich entwickelte Seitenleiste, Agentenvertrag und persistierten Lernzustand.
Provider und Kontext
Die Oberfläche hängt nicht von einem einzelnen Anbieter ab: AGY CLI, Codex CLI und ChatGPT werden über normalisierte Adapter angesprochen. Jede Anfrage besitzt ein begrenztes Kontextbudget. Lokale Markdown-Recherche und Wikilinks werden nur auf Anforderung genutzt; ein Link ist kein Beweis für eine Behauptung.
Lernevidenz und Freigabe
Lernziele bilden einen gerichteten Abhängigkeitsgraphen; bewertete Antworten werden im Vault gespeichert. Hinweise zählen nicht als selbstständiger Kompetenznachweis. Markdown-Änderungen werden vor ihrer Anwendung angezeigt und benötigen eine ausdrückliche Zustimmung über die Obsidian-API.
Ergebnis und Grenzen
NOX verbindet kontextuelle Fragen, Übung, Wiederholung und kontrolliertes Bearbeiten. OAuth-Anmeldung, echtes Desktop-Streaming, Latenz und Lernerfolg brauchen weitere Feldtests; simulierte CI-Tests beweisen diese Eigenschaften nicht.
概要
NOXはObsidianで動作するAI学習アシスタントです。開いているノートを明示的な文脈として利用し、説明、想起練習、復習、Markdownの変更提案を提供します。私はサイドバー、Agent境界、学習状態の保存を実装しました。
AgentとContextの境界
UIは特定のProviderに依存せず、AGY CLI、Codex CLI、ChatGPTを共通契約で扱います。各ターンのContextには上限があり、ローカルMarkdownとwikilinkの検索は明示的に実行します。ノート間のリンクは参考情報であり、事実の証明ではありません。
学習Evidenceと編集承認
学習目標は前提条件のグラフとして検証され、解答と評価のEvidenceはVaultに保存されます。ヒントを使った正答は独立した習得とは扱いません。Markdown変更はプレビューを提示し、承認後にObsidian APIを通じて適用します。
結果と制限
NOXは文脈付きチャット、練習、復習、安全な編集を一か所にまとめます。OAuth、DesktopのStreaming、Latency改善、学習効果は実環境での検証が必要です。Mock CIだけでは保証できません。