{ "@context": "https://schema.org", "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-10-03-amp-typescript-sdk/#webpage", "@type": [ "WebPage", "ArchiveComponent" ], "articleBody": "Today we've launched the Amp TypeScript SDK. It allows you to programmatically use the Amp agent in your TypeScript programs.\n\nHere is a program, for example, that instructs the Amp agent to find and list specific files in a folder using a [custom toolbox tool](https://ampcode.com/news/toolboxes):\n\n```typescript\nimport { AmpOptions, execute } from '@ampcode/sdk'\nimport path from 'path'\n\nconst prompt = `\n\tWhat files use authentication in this directory?\n\tGo through all the files and folders.\n\tUse the format_file_tree tool to format results.\n\tOnly output the file tree.\n`\n\nconst options: AmpOptions = {\n\tcwd: path.join(process.cwd(), 'src'), // Run in `./src` folder\n\tdangerouslyAllowAll: true, // Allow all tools, trust in Amp\n\ttoolbox: path.join(process.cwd(), 'toolbox'), // Location of custom toolbox\n}\n\n// execute starts the agent and streams messages\nconst messages = execute({ prompt, options })\n\nfor await (const message of messages) {\n\t// A system message contains information about the current session\n\tif (message.type === 'system') {\n\t\tconsole.log(`Started thread: ${message.session_id}`)\n\n\t\t// For example, the custom tools that were found in the toolbox\n\t\tconsole.log(\n\t\t\t'Available tools in Toolbox: ',\n\t\t\tmessage.tools.filter((tool) => tool.startsWith('tb__')).join(', '),\n\t\t)\n\t} else if (message.type === 'assistant') {\n\t\t// An assistant message contains the assistants text replies\n\t\t// or tool uses\n\t\tconsole.log('Assistant:', message)\n\t} else if (message.type === 'result') {\n\t\t// A result message contains the last message of the assistant\n\t\tconsole.log('Files using authentication:', message.result)\n\t}\n}\n```\n\nYou only need to install one package to get started:\n\n```shell-session\n$ npm install @ampcode/sdk\n```\n\nSince you can invoke Amp in any TypeScript program, there are very few limits to what you can build. Here are some ideas and examples of things we've built internally:\n\n- **Code Review Agent**: Automated pull request analysis and feedback\n- **Documentation Generator**: Create and maintain project documentation\n- **Test Automation**: Generate and execute test suites\n- **Migration Assistant**: Help upgrade codebases and refactor legacy code\n- **CI/CD Integration**: Smart build and deployment pipelines\n- **Issue Triage**: Automatically categorize and prioritize bug reports\n\nTo get more ideas and familiar with the SDK, take a look at the examples in the [manual](https://ampcode.com/manual/sdk#advanced-usage).\n", "authors": [], "captured_at": "2026-10-04T12:50:30.804479567+00:00", "category": "programming", "content_html": "

Today we've launched the Amp TypeScript SDK. It allows you to programmatically use the Amp agent in your TypeScript programs.

\n

Here is a program, for example, that instructs the Amp agent to find and list specific files in a folder using a custom toolbox tool:

\n
import { AmpOptions, execute } from '@ampcode/sdk'\nimport path from 'path'\n\nconst prompt = `\n\tWhat files use authentication in this directory?\n\tGo through all the files and folders.\n\tUse the format_file_tree tool to format results.\n\tOnly output the file tree.\n`\n\nconst options: AmpOptions = {\n\tcwd: path.join(process.cwd(), 'src'), // Run in `./src` folder\n\tdangerouslyAllowAll: true, // Allow all tools, trust in Amp\n\ttoolbox: path.join(process.cwd(), 'toolbox'), // Location of custom toolbox\n}\n\n// execute starts the agent and streams messages\nconst messages = execute({ prompt, options })\n\nfor await (const message of messages) {\n\t// A system message contains information about the current session\n\tif (message.type === 'system') {\n\t\tconsole.log(`Started thread: ${message.session_id}`)\n\n\t\t// For example, the custom tools that were found in the toolbox\n\t\tconsole.log(\n\t\t\t'Available tools in Toolbox: ',\n\t\t\tmessage.tools.filter((tool) => tool.startsWith('tb__')).join(', '),\n\t\t)\n\t} else if (message.type === 'assistant') {\n\t\t// An assistant message contains the assistants text replies\n\t\t// or tool uses\n\t\tconsole.log('Assistant:', message)\n\t} else if (message.type === 'result') {\n\t\t// A result message contains the last message of the assistant\n\t\tconsole.log('Files using authentication:', message.result)\n\t}\n}\n
\n

You only need to install one package to get started:

\n
$ npm install @ampcode/sdk\n
\n

Since you can invoke Amp in any TypeScript program, there are very few limits to what you can build. Here are some ideas and examples of things we've built internally:

\n\n

To get more ideas and familiar with the SDK, take a look at the examples in the manual.

\n", "content_markdown": "Today we've launched the Amp TypeScript SDK. It allows you to programmatically use the Amp agent in your TypeScript programs.\n\nHere is a program, for example, that instructs the Amp agent to find and list specific files in a folder using a [custom toolbox tool](https://ampcode.com/news/toolboxes):\n\n```typescript\nimport { AmpOptions, execute } from '@ampcode/sdk'\nimport path from 'path'\n\nconst prompt = `\n\tWhat files use authentication in this directory?\n\tGo through all the files and folders.\n\tUse the format_file_tree tool to format results.\n\tOnly output the file tree.\n`\n\nconst options: AmpOptions = {\n\tcwd: path.join(process.cwd(), 'src'), // Run in `./src` folder\n\tdangerouslyAllowAll: true, // Allow all tools, trust in Amp\n\ttoolbox: path.join(process.cwd(), 'toolbox'), // Location of custom toolbox\n}\n\n// execute starts the agent and streams messages\nconst messages = execute({ prompt, options })\n\nfor await (const message of messages) {\n\t// A system message contains information about the current session\n\tif (message.type === 'system') {\n\t\tconsole.log(`Started thread: ${message.session_id}`)\n\n\t\t// For example, the custom tools that were found in the toolbox\n\t\tconsole.log(\n\t\t\t'Available tools in Toolbox: ',\n\t\t\tmessage.tools.filter((tool) => tool.startsWith('tb__')).join(', '),\n\t\t)\n\t} else if (message.type === 'assistant') {\n\t\t// An assistant message contains the assistants text replies\n\t\t// or tool uses\n\t\tconsole.log('Assistant:', message)\n\t} else if (message.type === 'result') {\n\t\t// A result message contains the last message of the assistant\n\t\tconsole.log('Files using authentication:', message.result)\n\t}\n}\n```\n\nYou only need to install one package to get started:\n\n```shell-session\n$ npm install @ampcode/sdk\n```\n\nSince you can invoke Amp in any TypeScript program, there are very few limits to what you can build. Here are some ideas and examples of things we've built internally:\n\n- **Code Review Agent**: Automated pull request analysis and feedback\n- **Documentation Generator**: Create and maintain project documentation\n- **Test Automation**: Generate and execute test suites\n- **Migration Assistant**: Help upgrade codebases and refactor legacy code\n- **CI/CD Integration**: Smart build and deployment pipelines\n- **Issue Triage**: Automatically categorize and prioritize bug reports\n\nTo get more ideas and familiar with the SDK, take a look at the examples in the [manual](https://ampcode.com/manual/sdk#advanced-usage).\n", "dateCreated": "2026-10-04T12:50:30.804479567+00:00", "date_created": "2025-10-03T00:00:00+00:00", "date_modified": "2025-10-03T00:00:00+00:00", "date_published": "2025-10-03T00:00:00+00:00", "description": "Today we've launched the Amp TypeScript SDK. It allows you to programmatically use the Amp agent in your TypeScript programs. Here is a program, for example, that instructs the Amp agent to find and list specific files in a folder using a…", "external_url": "https://ampcode.com/news/typescript-sdk", "git": { "commit": "ebb0941c5c06a2ab2377342d607535262a3e969e", "path": "items/ampcode-com/2025/10/2025-10-03-amp-typescript-sdk.md", "permalink": "https://github.com/aymericbeaumet/aggr-instance/blob/ebb0941c5c06a2ab2377342d607535262a3e969e/items/ampcode-com/2025/10/2025-10-03-amp-typescript-sdk.md" }, "id": "urn:aggr:item:4c88e68c94fd839db14c1526ff4577a3562cd4e0", "isBasedOn": { "@id": "https://ampcode.com/news/typescript-sdk" }, "mainEntity": { "@id": "https://ampcode.com/news/typescript-sdk", "@type": "CreativeWork", "archivedAt": { "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-10-03-amp-typescript-sdk/#webpage" }, "dateModified": "2025-10-03T00:00:00+00:00", "datePublished": "2025-10-03T00:00:00+00:00", "headline": "Amp TypeScript SDK", "timeRequired": "PT2M", "url": "https://ampcode.com/news/typescript-sdk", "wordCount": 312 }, "name": "Archived snapshot: Amp TypeScript SDK", "preview": null, "reading_minutes": 2, "replicated_at": null, "source": "ampcode-com", "source_name": "Amp News", "summary": "Today we've launched the Amp TypeScript SDK. It allows you to programmatically use the Amp agent in your TypeScript programs. Here is a program, for example, that instructs the Amp agent to find and list specific files in a folder using a custom toolbox tool: import { AmpOptions, execute } from '@ampcode/sdk' import path from 'path' const prompt = ` What files use authentication in this directory? Go through all the files and folders. Use the format_file_tree tool to format results. Only output the file tree. ` const options: AmpOptions = { cwd: path.join(process.cwd(), 'src'), // Run in `./src` folder dangerouslyAllowAll: true, // Allow all tools, trust in Amp toolbox: path.join(process.cwd(), 'toolbox'), // Location of custom toolbox } // execute starts the agent and streams messages const messages = execute({ prompt, options }) for await (const message of messages) { // A system message contains information about the current session if (message.type === 'system') { console.log(`Started thread: ${message.session_id}`) // For example, the custom tools that were found in the toolbox console.log( 'Available tools in Toolbox: ', message.tools.filter((tool) => tool.startsWith('tb__')).join(', '), ) } else if (message.type === 'assistant') { // An assistant message contains the assistants text replies // or tool uses console.log('Assistant:', message) } else if (message.type === 'result') { // A result message contains the last message of the assistant console.log('Files using authentication:', message.result) } } You only need to install one package to get started: $ npm install @ampcode/sdk Since you can invoke Amp in any TypeScript program, there are very few limits to what you can build. Here are some ideas and examples of things we've built internally: Code Review Agent: Automated pull request analysis and feedback Documentation Generator: Create and maintain project documentation Test Automation: Generate and execute test suites Migration Assistant: Help upgrade codebases and refactor legacy code CI/CD Integration: Smart build and deployment pipelines Issue Triage: Automatically categorize and prioritize bug reports To get more ideas and familiar with the SDK, take a look at the examples in the manual.", "tags": [], "temporalCoverage": "2026-10-04T12:50:30.804479567+00:00", "title": "Amp TypeScript SDK", "url": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-10-03-amp-typescript-sdk/", "word_count": 312 }