Claude Code, Codex and OpenCode plugin that builds LLM-compiled, Obsidian-compatible knowledge bases through parallel research, source ingestion and querying.
1.4K135PythonMITUpdated 20 days ago
HurricaHjz/SecondSelf
A personal AI agent framework in Obsidian: Claude Code coordinates helper agents and a self-maintained, cited local wiki serves as its long-term memory.
- Stars
- 147
- Forks
- 12
- Open issues
- 0
- Last commit
- 21 days ago
What is it?
Second Yourself is a framework for building a personal AI agent that remembers the user's material and can act on it. A frontier model handles reasoning, a multi-agent harness coordinates helper agents under written rules, and a Markdown wiki kept on the user's machine stores long-term knowledge. Today it runs in Claude Code or the Claudian plugin inside Obsidian, with GPT models as helper agents through the Codex CLI.
The main working mode is a research assistant. You drop PDFs, slides, web pages and other files into the vault, and the agent compiles them into linked notes, maintains cross-references and a catalogue, and answers questions with citations to the notes it used. Each note carries a confidence level, and the wiki can be checked for broken links, orphans and conflicting claims.
The project is pre-1.0 and its design changes often. Setup requires Obsidian, an authenticated coding agent, and MarkItDown for document conversion. A bundled demo wiki can be loaded with `setup.sh --with-example` to see the output before building your own knowledge base.
Key features
- 01Compiles PDFs, slides, web pages and other files into linked Markdown notes inside an Obsidian vault.
- 02Answers questions from the wiki with citations to the notes it drew on.
- 03Assigns each note a confidence level and flags conflicting claims and knowledge gaps.
- 04Runs helper agents, including GPT models through the Codex CLI, under written file-write permissions.
- 05Includes lint and deep-lint passes to check links, orphans and stale claims.
- 06Lets users customise the agent's name, tone and standing preferences in a CUSTOMISATION.md file.
Use cases
- Building a research library from papers and articles, then asking questions against it with cited answers.
- Maintaining a personal knowledge base in Obsidian that an AI agent can read and extend over time.
- Running a shared wiki that a team of coding or research agents draws from.
- Adapting the note types and workflow to a field other than AI research.
Quick start
- 1
Install the MarkItDown converter with pip
pip install 'markitdown[all]' - 2
Clone the repository
git clone https://github.com/HurricaHjz/second-yourself.git - 3
Enter the cloned folder
cd second-yourself - 4
Run setup once before first use (or use the bundled demo with setup.sh --with-example)
bash setup.sh
Things to know
- Pre-release, and the design changes often until v1.0.
- Needs Claude Code or the Claudian plugin inside Obsidian, plus an API or plan quota.
- GPT helper agents require an installed and authenticated Codex CLI.
- The professor-loop authoring workflow is not included in this version.
Topics
FAQ
- What is SecondSelf?
- A personal AI agent framework in Obsidian: Claude Code coordinates helper agents and a self-maintained, cited local wiki serves as its long-term memory. Second Yourself is a framework for building a personal AI agent that remembers the user's material and can act on it. A frontier model handles reasoning, a multi-agent harness coordinates helper agents under written rules, and a Markdown wiki kept on the user's machine stores long-term knowledge. Today it runs in Claude Code or the Claudian plugin inside Obsidian, with GPT models as helper agents through the Codex CLI.
- Is SecondSelf free to use? What license does it have?
- SecondSelf is open source under the MIT license. Check the license terms before using it in commercial products.
- Is SecondSelf still maintained?
- Actively maintained. The last commit to SecondSelf was on Oct 1, 2026.
- What can I use SecondSelf for?
- Building a research library from papers and articles, then asking questions against it with cited answers. Maintaining a personal knowledge base in Obsidian that an AI agent can read and extend over time. Running a shared wiki that a team of coding or research agents draws from. Adapting the note types and workflow to a field other than AI research.
- How do I install SecondSelf?
- Install the MarkItDown converter with pip: pip install 'markitdown[all]' Clone the repository: git clone https://github.com/HurricaHjz/second-yourself.git Enter the cloned folder: cd second-yourself Run setup once before first use (or use the bundled demo with setup.sh --with-example): bash setup.sh
- Where can I get SecondSelf?
- The source code and installation instructions are on GitHub: https://github.com/HurricaHjz/SecondSelf
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A deep research skill and pipeline for Claude Code and OpenAI Codex that gathers web and scholarly sources into a persistent, searchable markdown vault and writes cited reports.
3.9K408PythonMITUpdated 12 days ago
A set of 8 AI agents and 14 skills that manage an Obsidian vault through chat, covering notes, email, calendar, and meeting transcripts.
3.9K374ShellOtherUpdated 4 months ago
An AI chief of staff built as plain markdown files in an Obsidian vault, tracking your calendar, commitments and rules, and producing a morning brief.
520MITUpdated 8 days ago
A set of Claude Code skills that walk academic work through research, writing, peer review, revision and finalization, with a human approving each stage.
53K4.1KPythonOtherUpdated 4 days ago
Open-source, inspectable framework for building an AI Agent Twin that distills your knowledge, memories and decisions into a grounded personal assistant.
58654PythonMITUpdated 2 days ago