wolfcha

Name: wolfcha
Author: oil-oil

Warning

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

684stars

60forks

TypeScript

Installation

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

Getting Started

Guides for using ai agents skills like wolfcha.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 5/12/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "next: Next.js self-hosted applications vulnerable to DoS via Image Optimizer remotePatterns configuration",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-12T06:40:04.150Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

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.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

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

Related Skills

ECC

by affaan-m

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

242,960

skillgrade old-coder

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Wolfcha — Play Werewolf solo

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 first	Table-aware memory	Decisions 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

Night falls — Werewolves choose a target while special roles act on private information.
The table speaks — Every surviving player explains, suspects, misdirects, or pushes a read.
Everyone votes — The group turns conversation into a decision.
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

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