setup

Configures Codepresso integrations including Notion, GitHub, Google Chat, and inbox scanning.

1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill setup-codepresso-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/codepresso-dev/codepresso-ai-plugin/tree/main/skills/setup
Command: npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill setup-codepresso-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Codepresso requires wiring together many external services — GitHub CLI authentication, Notion databases, sprint workflows, Google Chat greetings, Gmail inbox scanning, and MCP tool permissions. Doing this manually means editing config files by hand and guessing at database IDs, which is error-prone and easy to get wrong. ## Core Features & Use Cases - Guided prerequisite checks: Verifies gh CLI authentication, Node.js version, and PR access before any configuration is written. - Notion and sprint workflow setup: Prompts for API keys and database IDs (with defaults), tests connections via MCP tools, and configures auto-transition, epic auto-complete, and PR title format preferences. - Optional integrations: Configures Google Chat daily greetings via gws CLI, Gmail + Chat inbox task scanning with due-date tracking, epic PRD generation, and AWS MFA credential bridging. - Use Case: A developer installs Codepresso in a new project and says "setup codepresso". The wizard walks them through GitHub auth, Notion workspace selection, sprint database configuration, and writes ~/.codepresso/config.json plus .claude/settings.local.json permissions automatically. ## Quick Start Ask the assistant to run the Codepresso setup wizard to configure Notion integration and sprint workflow for this project.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Codepresso with Notion integration?▼

Run the setup wizard by saying "setup codepresso". It verifies gh CLI authentication, prompts for your Notion API key and database ID, tests the connection via MCP tools, and writes the configuration to ~/.codepresso/config.json.

How do I configure the sprint workflow databases in Codepresso?▼

During setup, the wizard asks for Sprint, Epic, and Task database IDs with pre-filled defaults you can accept or override. It then tests each database with a query and lets you set preferences for auto-transition, epic auto-complete, and PR title format.

What prerequisites does Codepresso setup require?▼

You need the gh CLI installed and authenticated, Node.js version 20 or higher, and optionally a Notion Internal Integration Token. For Google Chat greetings you also need the gws CLI authenticated with chat.messages.create scope.

Can I use Codepresso without Notion integration?▼

Yes, Notion configuration is optional and the wizard asks before enabling it. However, sprint workflow automation, epic PRD generation, and inbox task tracking all depend on Notion being configured first.

Why does the inbox scan setup fail to authenticate Gmail?▼

Gmail authentication requires completing the OAuth flow through the claude_ai_Gmail MCP connector. If authentication fails, setup continues with Chat-only scanning and emits a warning to re-run setup later.

Where does Codepresso store its configuration files?▼

Global configuration is written to ~/.codepresso/config.json, with optional per-project overrides in .codepresso.json. MCP tool permissions are merged into .claude/settings.local.json to avoid repeated permission prompts.