Navigate to Repo Settings
- Go to your GitHub repository that you forked, it should have the name “codespace-executor”.
- Click on the Settings tab (you need admin access)
- In the left sidebar, click Secrets and variables
- Click Codespaces
Add Repo Secrets
- Click New repository secret
- Enter the secret name with KEYBOARD_ prefix in the following format KEYBOARD_APPNAME_API_KEY (e.g. KEYBOARD_TYPEFORM_API_KEY)
- Enter the secret value (your actual API key)
- Click Add secret
Tips
- Once you’ve added the secrets you will have to reset any codespaces already running (you can ask Keyboard to delete existing codespaces)
- In Claude desktop ask what environment variables Keyboard has access to in order to confirm the connection worked
- Start asking Claude to perform tasks in your connected apps once it confirms it has access to
Security overview
What does Keyboard have access to?
Keyboard does not have access to the API keys you input. Those are stored in your private GitHub repo. Keyboard only knows that the environment variable is available to point Claude to when ready to execute a task. By default you will always have the ability to to approve or deny any task before Claude goes and executes a task leveraging the API key (you can also turn this final approval off if you want).Best practices for AI-driven environment variable naming
Do:- Use uppercase names with the KEYBOARD_ prefix
- Include the service name in the variable name
- Use consistent naming patterns across your project
Avoid these common mistakes
- Generic names like KEY, SECRET, or TOKEN
- Lowercase or mixed-case names
- Ambiguous abbreviations
- Storing secrets in code or configuration files
- Using production keys in development environments
Step-by-step integration examples
Typeform integration
Typeform integration
Getting Your Typeform API Key:
- Log in to Typeform
- Click on your profile picture → Settings
- Go to Personal tokens
- Click Generate a new token
- Give it a descriptive name (e.g., “Keyboard Development”)
- Copy your personal access token (starts with tfp_)
- Secret Name: KEYBOARD_TYPEFORM_API_KEY
- Secret Value: tfp_your_actual_token_here
SendGrid email integration
SendGrid email integration
Getting Your SendGrid API Key:
- Log in to SendGrid
- Go to Settings → API Keys
- Click Create API Key
- Choose Full Access or configure specific permissions
- Copy your API key (starts with SG.)
- Secret Name: KEYBOARD_SENDGRID_API_KEY
- Secret Value: SG.your_sendgrid_api_key_here
- Secret Name: KEYBOARD_SENDGRID_FROM_EMAIL
- Secret Value: your_verified_sender@example.com