[dodeja]

What

Adds README.md at the repo root (90 lines). It covers:

• What Terminal49 is and what this repo contains.
• A table that maps each directory to what ships from it.
• Quick starts for curl, the SDK, the CLI, and the hosted MCP server.
• Development commands, with links to AGENTS.md for generated files.
• A security note.

Why

The repo had no root README, so its GitHub front page was empty for API integrators, SDK and CLI users, and contributors.

Verification

• Checked every fact against the source: the auth header (docs/openapi.json), package and bin names (package.json files), the connector URL (AGENTS.md, docs/mcp/home.mdx), the Node version (.tool-versions), and the commands (AGENTS.md).
• All relative links resolve, including the AGENTS.md anchors.
• Docs-site, developer-portal, and viteplus.dev URLs return 200.
• The npmjs.com and claude.ai links return a Cloudflare challenge (403) to curl. Both npm packages exist in the registry, and docs/mcp/home.mdx already uses the same Claude Directory link.
• vp run check passes. The README sits outside docs/, so Mintlify does not publish it.

Open questions

• The repo has no SECURITY.md. The README points security reports to support@terminal49.com, the support address the docs use.
• The repo has no root LICENSE. Only sdks/typescript-sdk-cli/ (MIT) has one, so the README says nothing about the license.

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

Confidence Score: 4/5

The PR appears safe to merge, with a small setup gap in the SDK example.

Findings

1.  SDK setup skips the key ▶

Fix with agent prompt

### Issue 1
README.md:43
The SDK quick start reads `T49_API_TOKEN` but never shows how to set it. If that variable is unset, someone following this section alone gets `AuthenticationError('API token is required')` before making a request. Add `export T49_API_TOKEN=YOUR_API_KEY` beside the install command, as the CLI example does.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds a root README.md with:

• API and client users can find a starting point in the root README.
• Contributors can find setup steps and working rules in the root README.

The SDK quick start should show how to set its API key.

_{Reviews (1) · Last reviewed commit: "docs: add a root README" · Reviewed by Greptile}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
api	Ready	Preview	Oct 19, 2026 4:23am UTC

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-19T04:24:41.646428Z	65fe46c	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 65fe46c2b8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Qualify the OAuth-only MCP quick start

For MCP clients that do not support a browser OAuth flow, this promise is incorrect: they cannot sign the user in and must instead send an API key, as documented in docs/mcp/home.mdx:66-69. Qualify these instructions for OAuth-capable clients or include the API-key fallback so the generic setup does not leave those clients unauthenticated.

AGENTS.md reference: AGENTS.md:L60-L62

Useful? React with 👍 / 👎.

[greptile-apps]

SDK setup skips the key

The SDK quick start reads T49_API_TOKEN but never shows how to set it. If that variable is unset, someone following this section alone gets AuthenticationError('API token is required') before making a request. Add export T49_API_TOKEN=YOUR_API_KEY beside the install command, as the CLI example does.

Prompt To Fix With AI

This is a comment left during a code review.
Path: README.md
Line: 43

Comment:
**SDK setup skips the key**

The SDK quick start reads `T49_API_TOKEN` but never shows how to set it. If that variable is unset, someone following this section alone gets `AuthenticationError('API token is required')` before making a request. Add `export T49_API_TOKEN=YOUR_API_KEY` beside the install command, as the CLI example does.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.