Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# X (Twitter) API Credentials
X_API_KEY=your_api_key_here
X_API_SECRET=your_api_secret_here
X_ACCESS_TOKEN=your_access_token_here
X_ACCESS_TOKEN_SECRET=your_access_token_secret_here
X_BEARER_TOKEN=your_bearer_token_here

# X Account Settings
X_USERNAME=your_twitter_username

# Grok/xAI Settings
XAI_API_KEY=your_xai_api_key_here

# Agent Settings
POLLING_INTERVAL_MS=30000
MAX_RETRIES=3
7 changes: 1 addition & 6 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -7,20 +7,15 @@
*.tsx @groupthinking
*.jsx @groupthinking
*.css @groupthinking
/frontend/ @groupthinking

# Backend
*.py @groupthinking
*.go @groupthinking
/backend/ @groupthinking
/api/ @groupthinking
*.ts @groupthinking
Comment on lines 11 to +13

# Infrastructure
/.github/ @groupthinking
*.yml @groupthinking
*.yaml @groupthinking
Dockerfile @groupthinking

# Documentation
*.md @groupthinking
/docs/ @groupthinking
54 changes: 54 additions & 0 deletions .github/PR_TITLE_GUIDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# PR Title Quick Reference

## Conventional Commits Format

All PR titles should follow the [Conventional Commits](https://www.conventionalcommits.org/) format:

**Format**: `<type>(<scope>): <description>`

### Types and Examples

| Type | When to Use | Example |
|------|-------------|---------|
| `feat` | New feature | `feat(agent): add autonomous reply functionality` |
| `fix` | Bug fix | `fix(xapi): correct mention polling interval` |
| `docs` | Documentation only | `docs: update README.md and simplify xAI instructions` |
| `refactor` | Code restructuring | `refactor(grok): simplify AI decision logic` |
| `chore` | Maintenance | `chore: update dependencies to latest versions` |
| `ci` | CI/CD changes | `ci: add PR validation workflow` |
| `style` | Formatting changes | `style: fix indentation in config files` |
| `test` | Test updates | `test: add unit tests for agent service` |
| `perf` | Performance improvements | `perf(xapi): optimize mention polling` |

### How to Update PR Title

1. Go to your PR page on GitHub
2. Click the "Edit" button next to the PR title
3. Update the title to follow the format above
4. Save changes

The PR validation workflow will then pass with no warnings.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Stop claiming the workflow will have no warnings.

A valid title only clears the title-format warning; pr-checks.yml can still fail on the description or warn for a large PR. Say the title check passes, not the whole workflow.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/PR_TITLE_GUIDE.md at line 30, Update the conclusion in
PR_TITLE_GUIDE.md to state only that a valid title clears the title-format check
or warning; remove the claim that the entire workflow passes without warnings,
since pr-checks.yml may still report description issues or large-PR warnings.


## Common Scenarios

### Documentation Updates
**Problem**: PR title like "updates to the `README.md`"
**Solution**: `docs: update README.md and simplify xAI instructions`

### Multiple File Changes
**Problem**: PR title like "various fixes"
**Solution**: Choose the primary change type:
- `fix: resolve polling and authentication issues`
- `refactor: restructure API client and services`

### Feature Additions
**Problem**: PR title like "new stuff"
**Solution**: `feat(agent): implement autonomous decision-making`

## Full Guidelines

For comprehensive contribution guidelines, see [CONTRIBUTING.md](/CONTRIBUTING.md).

---

**Note**: The PR validation workflow treats conventional commits format as a **warning** (not an error), so PRs will not be blocked. However, following this format improves project maintainability and changelog generation.
17 changes: 17 additions & 0 deletions .github/agents/my-agent.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
# Fill in the fields below to create a basic custom agent for your repository.
# The Copilot CLI can be used for local testing: https://gh.io/customagents/cli
# To make this agent available, merge this file into the default repository branch.
# For format details, see: https://gh.io/customagents/config

name: molt
description: An agent for the molt project.
---

# molt Agent

This agent assists with tasks related to the molt project. You can ask it to:
- [Capability 1]
- [Capability 2]

For more information, visit https://www.molt.bot/.
Comment on lines +13 to +17

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Replace the template garbage.

[Capability 1] and [Capability 2] ship an agent with no actual contract. Document the repository-specific tasks it can perform and remove the unrelated placeholder text.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/agents/my-agent.agent.md around lines 13 - 17, Replace the
placeholder capability entries and unrelated template text in the agent
description with a concise, repository-specific contract describing the actual
molt tasks this agent supports. Keep the introductory purpose clear and retain
only relevant project information, including the molt website link if
appropriate.

Loading