Skip to content

Tight-Line/pinchy

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

606 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Pinchy

Pinchy

Self-hosted AI agent platform built on OpenClaw.
Enterprise-ready. Offline-capable. Open source.

Docs β€’ Website β€’ Blog β€’ Discussions β€’ LinkedIn


What is Pinchy?

Pinchy is an enterprise layer on top of OpenClaw β€” the open-source AI agent framework. OpenClaw is incredibly powerful for individual power users. But for teams and companies, critical pieces are missing: permissions, audit trails, user management, and governance.

Pinchy fills that gap.

The Problem

You want AI agents in your company. But:

  • Cloud platforms (Dust, Glean, Copilot Studio) send your data to external servers. For regulated industries in the EU, that's a non-starter.
  • Workflow builders (n8n, Dify) let you chain steps visually β€” but they're not autonomous agents.
  • Frameworks (CrewAI, LangChain) are libraries, not platforms. No UI, no permissions, no deployment story.
  • OpenClaw is the best open-source agent runtime β€” but it has no user management, no role-based access, no audit trail.

The Solution

Pinchy wraps OpenClaw into something enterprises can trust:

  • Plugin Architecture β€” Agents get scoped tools, not raw shell access. A "Create Jira Ticket" plugin instead of exec.
  • Role-Based Access Control β€” Who can use which agent. What each agent can do. Per team, per role.
  • Audit Trail β€” Every agent action logged. Who, what, when. Compliance-ready.
  • Cross-Channel Workflows β€” Input on email, output on Slack. Properly routed, properly permissioned.
  • Self-Hosted & Offline β€” Your server, your data, your models. Works without internet.
  • Model Agnostic β€” OpenAI, Anthropic, local models via Ollama. Your choice.

Get Started

See the Installation Guide for setup instructions, configuration, and development setup.

Status

Pinchy is in early development. The core is working β€” setup, auth, multi-user, agent chat, permissions, knowledge base agents, and audit trail. We're building the enterprise features (granular RBAC, plugin marketplace, cross-channel workflows) next.

What works today

  • Setup wizard β€” Create your admin account on first run
  • Authentication β€” Credentials-based login with database sessions
  • Multi-user β€” Invite users, admin and user roles, personal and shared agents
  • Agent chat β€” Real-time WebSocket chat with OpenClaw agents, conversation history
  • Agent permissions β€” Allow-list model for agent tools (safe and powerful categories)
  • Agent settings β€” Configure name, model, system prompt, and tool permissions per agent
  • Knowledge Base agents β€” Create agents with scoped read-only access to specific directories
  • Context management β€” Per-user personal context and organization-wide context, editable in Settings
  • Smithers onboarding β€” New users get an onboarding interview where Smithers learns about them through conversation
  • Provider management β€” Configure API keys for Anthropic, OpenAI, and Google
  • Docker Compose deployment β€” Single command to run the full stack
  • Audit trail β€” Cryptographic audit logging with HMAC-signed entries, integrity verification, and CSV export
  • CI pipeline β€” Automated linting, testing, and security auditing

What's coming

  • Full RBAC with team-scoped permissions
  • Plugin marketplace for agent tools
  • Cross-channel workflows (email, Slack)
  • Admin dashboard with usage analytics

Follow our progress on the blog and LinkedIn.

Tech Stack

Layer Technology
Frontend Next.js 16, React 19, TailwindCSS v4, shadcn/ui
Auth Better Auth (email/password, DB sessions)
Database PostgreSQL 17, Drizzle ORM
Agent Runtime OpenClaw Gateway (WebSocket)
Testing Vitest, React Testing Library
CI/CD GitHub Actions, ESLint, Prettier, Husky
Deployment Docker Compose

Origin Story

Pinchy started when an AI agent sent a WhatsApp message it shouldn't have β€” leaking its entire internal reasoning process to a friend instead of a simple "Sure, let's grab lunch!" That moment made one thing clear: AI agents without proper guardrails are a liability, not an asset.

Read the full story on heypinchy.com.

Philosophy

We care about how Pinchy feels, not just what it does. Security + Ease is our core tension β€” enterprise-grade protection that feels light, not intimidating. Smart defaults everywhere, personality templates instead of blank slates, zero-config setup, and full customization when you need it.

Read more in our Philosophy docs and PERSONALITY.md.

Contributing

We love contributions! Whether it's code, docs, bug reports, or ideas β€” all are welcome.

Please read our Contributing Guide before submitting a PR. If you're writing any user-facing text, also check our Personality Guide.

Community

  • GitHub Discussions β€” Questions, ideas, show & tell
  • Issues β€” Bug reports and feature requests
  • Blog β€” Build in public updates
  • LinkedIn β€” Daily updates from the founder

License

Pinchy is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means you can use, modify, and distribute Pinchy freely β€” but if you run a modified version as a network service, you must release your changes under the same license. This protects the project from being turned into a proprietary cloud service without giving back.

Who's Behind This

Pinchy is built by Clemens Helm β€” a software developer with 20+ years of experience, daily OpenClaw power user, and believer in self-hosted AI.

Built in Vienna, Austria.

About

Self-hosted AI agent platform built on OpenClaw. Enterprise-ready, offline-capable, open source. 🦞

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 98.8%
  • Other 1.2%