Agent access
Your repositories. One agent workflow.
Give your coding agent one skill to prepare your portfolio, gather relevant project history, upload context, run checks and submit the repositories you choose.
MCP or HTTP for service actions. Local Git for code changes. Computer use only when an export or owner approval needs it.
Start with this instruction
Read https://codemerchant.ai/skills/codemerchant-intake/SKILL.md and its linked references. Sign in with my GitHub login, prepare my selected repositories for CodeMerchant, collect relevant context and local agent traces from Claude, Codex and other coding tools within the company/repository scope I authorize, review and upload those files to the correct destinations, fix reviewable issues, and verify each submission. Ask me for any missing access or owner decisions.
Save SKILL.md in your agent’s skill directory. Download its linked references and upload helper alongside it, or let your agent retrieve them from this site.
Repository copying skill
Bring your issues and pull requests along
Copy a repository to your own account with its commits, issues, pull requests, comments and closing links. This skill guides your agent through a complete inventory, faithful copying and verification, with original authors and dates attributed where GitHub cannot preserve them.
Read https://codemerchant.ai/skills/copy-github-collaboration-history/SKILL.md and its linked API procedure. Help me choose the source and destination repositories, then copy their Git and collaboration history and verify the result.
Give your agent the instruction above, or save these files together with their folder structure. The inventory helper needs Python 3 and an authenticated GitHub CLI. No CodeMerchant account is required.
01
Choose the portfolio
You authorize the repositories and sources. Your agent inventories connected private GitHub repositories and records anything it cannot access.
02
Bring the project history
Your agent gathers relevant Linear issues, Slack threads, specs and coding sessions through authorized connectors, or helps you export them.
03
Prepare, upload and check
Your agent reviews and formats context, attaches it to the right repositories, verifies extraction and runs quality and privacy checks.
04
Fix and submit
Your agent prepares reviewable code fixes, rescans with context and submits your authorized selection. You retain history-publication and commercial decisions.
Bring the work behind the code
Connect the sources your agent can read, or export the relevant project yourself. Useful context includes Linear issues and comments, Slack project threads, design documents, decisions and local agent traces from Claude, Codex and other coding tools. Your agent collects matching sessions from your computer, preserves prompts, replies and tool activity, and uploads reviewed copies for each authorized company and repository.
Choose which sources may be shared. The original uploaded files are saved for administrator review. Your agent should review private material first, keep source references, verify each attachment and flag missing exports.
See what to export from each source →Your agent handles
- Inventory and a result for every selected repository.
- Relevant context collection, formatting and verified uploads.
- Checks, reviewable fixes, rescans and authorized submission.
You control
- GitHub access, repository selection and context sharing.
- Data License acceptance and submission authorization.
- Publishing rewritten history, merging changes and commercial decisions.
Connect your agent
First connect GitHub and accept the Data License in your dashboard. Then create a 90-day token. Enable uploads and submission for the full intake workflow; existing analysis tokens keep their current permissions.
Store the token in your secret manager as CODEMERCHANT_API_TOKEN. It appears once and is stored only as a hash. Expand the variable using your client’s supported configuration; never paste a token into chat or a repository.
{
"mcpServers": {
"codemerchant": {
"type": "http",
"url": "https://codemerchant.ai/api/mcp",
"headers": {
"Authorization": "Bearer ${CODEMERCHANT_API_TOKEN}"
}
}
}
}Tools for the whole intake
get_repository_reportRead the latest source-free report and scan status for a connected repository.
GET /api/v1/reports/{owner}/{name}scan_repositoriesRun an owner-selected bounded batch using saved completed context applicable to each repository. Inspect scanned, failed and remaining. On data_license_required, follow the returned message: show the owner the terms and accept only after their explicit yes.
POST /api/v1/scansget_data_licenseRead the current Data License version, summary, acknowledgements, agreement link and whether the owner has accepted it.
GET /api/v1/data-licenseaccept_data_licenseAccept the Data License for the owner. First show the owner the summary, agreement link and every acknowledgement word for word from get_data_license and ask whether they accept. Call this only after they explicitly say yes, passing that version, every acknowledgement true, and their reply quoted as ownerConfirmation. Never accept without their explicit yes.
POST /api/v1/data-licenselist_repositoriesRead the saved connected repository inventory.
GET /api/v1/repositoriesrefresh_inventoryRefresh connected repositories and report unavailable installations.
POST /api/v1/repositoriescontext_uploadInitiate, complete, check, list or change the scope of uploads. Transfer file bytes to the returned uploadUrl using HTTP PUT.
POST /api/v1/context-uploadsscan_with_contextScan one selected repository. Omit contextIds or send an empty array to reuse all saved completed context applicable to it; nonempty IDs select specific uploads. Use refresh true after reviewed fixes. Requires owner Data License acceptance.
POST /api/v1/context-scanslist_submissionsRead saved submission IDs and review stages.
GET /api/v1/submissionssubmit_repositoriesSubmit the owner-authorized repository selection with completed analyses. Requires owner Data License acceptance. Does not approve a sale or payout. A saved response means the selection is stored; listing "unavailable" means only the read-back failed, so re-read list_submissions instead of resubmitting. On github_rate_limited, wait retryAfterSeconds before retrying.
POST /api/v1/submissionsrefresh_submissionRefresh the analysis of one existing submission after fixes.
POST /api/v1/submissions/refreshHistory cleanup is a separate, reviewable step
A normal code fix leaves earlier commits intact. Your agent can prepare and validate a rewrite in a private mirror, preserve provenance and show you the affected refs before publication. Publishing rewritten history requires your explicit approval.
Read the history-cleanup procedure →Repository ingestion currently uses connected private GitHub repositories. Standalone source archives and final vendor-package delivery are not supported. Website remediation can require owner GitHub approval; your agent can also prepare fixes through its own authorized Git tools. Submission records your application for review, not a sale or payout.