Skip to content

e-candeloro/open_teacher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Teacher

Turn your AI coding agent into a learning coach.

OpenCode Claude Code GitHub Copilot Shell Installer

Note

AI coding assistants are great at producing answers. But if they always solve everything for you, it is easy to stop thinking. Open Teacher adds a learning mode for OpenCode, Claude Code, and GitHub Copilot. It nudges your agent to teach through small steps, tradeoff questions, predictions, verification, and reusable takeaways.

Use it when you want to build and understand software, while actually improving as an engineer.

What Gets Installed?

You can choose between a local (current folder project) or global (always available) installs.

Provider Installed files
OpenCode learn primary agent, docsearch subagent, learning-mode-guidelines skill
Claude Code learn agent, learning-mode-guidelines skill
GitHub Copilot workspace/user instructions, prompt file for local install, learning-mode custom agent

The learning-mode-guidelines skill is specific to this learning-mode pack. It does not replace or restrict other skills.

Recommended MCP Requirements

Strongly recommended: install the Context7 MCP server from https://github.com/upstash/context7.

Then run:

npx ctx7 setup

This is especially useful for the docsearch subagent, which may use Context7 when it is available. The agent still works without it, but documentation lookup is usually better when Context7 is set up.

One Command Install (opencode)

Use one provider and one scope, for example install for opencode in the current folder (local agent)

tmp="$(mktemp -d)" && git clone --depth 1 https://github.com/e-candeloro/open_teacher.git "$tmp" && bash "$tmp/scripts/install.sh" opencode local

To instead install globally:

tmp="$(mktemp -d)" && git clone --depth 1 https://github.com/e-candeloro/open_teacher.git "$tmp" && bash "$tmp/scripts/install.sh" opencode global

Other providers

Provider Local Install (Current Folder) Global Install
Claude tmp="$(mktemp -d)" && git clone --depth 1 [https://github.com/e-candeloro/open_teacher.git](https://github.com/e-candeloro/open_teacher.git) "$tmp" && bash "$tmp/scripts/install.sh" claude local tmp="$(mktemp -d)" && git clone --depth 1 [https://github.com/e-candeloro/open_teacher.git](https://github.com/e-candeloro/open_teacher.git) "$tmp" && bash "$tmp/scripts/install.sh" claude global
Copilot tmp="$(mktemp -d)" && git clone --depth 1 [https://github.com/e-candeloro/open_teacher.git](https://github.com/e-candeloro/open_teacher.git) "$tmp" && bash "$tmp/scripts/install.sh" copilot local tmp="$(mktemp -d)" && git clone --depth 1 [https://github.com/e-candeloro/open_teacher.git](https://github.com/e-candeloro/open_teacher.git) "$tmp" && bash "$tmp/scripts/install.sh" copilot global

Install Locations

Provider Local paths Global paths
OpenCode .opencode/agents/, .opencode/skills/learning-mode-guidelines/ ~/.config/opencode/agents/, ~/.config/opencode/skills/learning-mode-guidelines/
Claude Code .claude/agents/, .claude/skills/learning-mode-guidelines/ ~/.claude/agents/, ~/.claude/skills/learning-mode-guidelines/
Copilot VS Code .github/copilot-instructions.md, .github/instructions/, .github/prompts/, .github/agents/ ~/.copilot/instructions/, ~/.copilot/agents/

Updating Existing Files

The installer asks before overwriting every existing file:

File exists: .opencode/agents/learn.md
Overwrite? [y/N]

The default is N. Choose y only for files you want to update.

Cleanup Prompt

When the installer is run from a temporary clone, it asks whether it can delete that cloned installer directory after installation.

Delete cloned installer directory /tmp/tmp.xxxxx? [y/N]

The default is N. The installer only offers this cleanup when the cloned repo is under your system temp directory and your current working directory is not inside that repo.

After Install

Restart OpenCode after installing OpenCode agents or skills.

Restart Claude Code after installing Claude Code agents or skills.

Reload VS Code if GitHub Copilot does not detect new instruction, prompt, or agent files immediately.

Uninstall

Remove the files listed in the install summary or delete the target files shown in the install locations table.

For OpenCode local installs, remove:

.opencode/agents/learn.md
.opencode/agents/docsearch.md
.opencode/skills/learning-mode-guidelines/

For Claude Code local installs, remove:

.claude/agents/learn.md
.claude/skills/learning-mode-guidelines/

For Copilot local installs, remove:

.github/copilot-instructions.md
.github/instructions/learning-mode.instructions.md
.github/instructions/learning-mode-guidelines.instructions.md
.github/prompts/learn.prompt.md
.github/agents/learning-mode.agent.md

Releases

No releases published

Packages

 
 
 

Contributors

Languages