wolfcha

AI-powered Werewolf (Mafia) social deduction game where every player is controlled by top LLMs like DeepSeek, Qwen, Gemini, and more

684
Stars
60
Forks
TypeScript
Language
8/23/2026
Added
View on GitHubDownload ZIP

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillTip is an informational directory and does not control or maintain the underlying repository. Any security checks displayed are automated and limited in scope. Review the source code before installing.

Read the Terms of Service

Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/oil-oil/wolfcha

Getting Started

Guides for using skills like wolfcha.

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

简体中文

Wolfcha — Play Werewolf solo

You take one seat. AI players fill the rest.
An AI-native Werewolf game for deduction, bluffing, and chaos on demand.

Play online · Run locally · 中文说明

One human. A table that talks back.

Wolfcha recreates the part of Werewolf that is hardest to schedule: a complete table of distinct players. Choose your role, enter an 8–12 seat game, and let the AI handle every other personality, secret, accusation, and vote.

Characters firstTable-aware memoryDecisions with intent
Each AI has a stable personality layered over a hidden game role.Players follow speeches, votes, deaths, and changing suspicions.They accuse, defend, bluff, follow, or hold back according to their faction goal.

What happens at the table

  1. Night falls — Werewolves choose a target while special roles act on private information.
  2. The table speaks — Every surviving player explains, suspects, misdirects, or pushes a read.
  3. Everyone votes — The group turns conversation into a decision.
  4. The story changes — New deaths and revealed information reshape the next round.

You can play as Villager, Werewolf, White Wolf King, Seer, Witch, Hunter, Guard, or Idiot. Conversations are generated in real time, so the same setup can produce a very different table.

Built for atmosphere

  • Retro visual direction with day/night eye-blink transitions.
  • Lip-sync animation while characters speak.
  • Dedicated role artwork for night actions.
  • Optional AI voice playback and spectator mode.

Project origin

Wolfcha was created at the Watcha × ModelScope Global Hackathon. The name combines Wolf with Cha (猹) — part Werewolf, part spectator watching a table of AI personalities collide.

Local development

Requirements: Node.js and pnpm.

git clone https://github.com/oil-oil/wolfcha.git
cd wolfcha
pnpm install
cp .env.example .env.local
pnpm dev

Open http://localhost:3000. Configure the providers you need in .env.local; the available variables are documented in .env.example.

Tech stack

Next.js 16 · TypeScript · Tailwind CSS 4 · Jotai · Radix UI · Framer Motion · Tiptap

Sponsors

TokenDance

  • TokenDance — core game flow, roleplay, and summaries
  • DashScope — AI capability support
  • Watcha — AI capability and showcase platform support

Roadmap

  • Better mobile play
  • Post-game review and free chat
  • Richer memory, bluffing, and table behavior
  • Special mechanics such as time rewind and AI insight
  • Multiplayer with friends and AI players
  • Community ratings for standout AI personalities

License

MIT

Frequently Asked Questions

What is wolfcha?

wolfcha is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by oil-oil. AI-powered Werewolf (Mafia) social deduction game where every player is controlled by top LLMs like DeepSeek, Qwen, Gemini, and more. It has 684 GitHub stars.

Is wolfcha safe to use?

wolfcha returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install wolfcha?

Clone the repository with "git clone https://github.com/oil-oil/wolfcha" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is wolfcha written in?

wolfcha is primarily written in TypeScript. It is open-source under oil-oil on GitHub, so you can review or fork the full source.

Are there alternatives to wolfcha?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh wolfcha against similar tools.

Comments (0)

No comments yet. Be the first to share your thoughts!

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,03119,897Shell
AI Agents
View details

Developers Also Liked

Based on votes and bookmarks from developers who liked this skill

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP Serversapisai-tools
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details
wolfcha — AI Skill for Claude Code | SkillTip