Project Layout - Telnyx

telnyx-acp create scaffolds one directory per agent, named after it. For support-agent:

support-agent/
├── agent.json        the agent: model, instructions file, numbers, email, web, channels, tools, memory, limits, approvals, voice, secret names
├── instructions.md   the system prompt
├── .gitignore        excludes .telnyx/ and node_modules/
├── README.md         the commands, for whoever opens the project
└── AGENTS.md         the same, written for a coding agent

The two files that define the agent, as written:

{
  "name": "support-agent",
  "kind": "configuration",
  "model": "zai-org/GLM-5.3-Flash",
  "instructions": "instructions.md",
  "channels": [],
  "tools": [],
  "secrets": []
}

You are support-agent, a helpful assistant. Answer briefly and plainly.

When you do not know something, say so and offer to find out.

agent.json is edited by telnyx-acp add, remove, set and unset, or by hand followed by validate; instructions.md is edited by hand. Neither holds a secret value: add secret stores the value on the platform and records only the name.

What the CLI Adds

Path	Written by	Contents
`.env`	The user, for `dev`	`TELNYX_API_KEY`, a provider key such as `OPENAI_API_KEY` when the model needs one, and an MCP server’s secret, which `add tool mcp` and `tools --refresh` read too. Never read on the platform.
`.telnyx/dev.json`	`dev`	The running local listener: its URL, the agent’s name and kind, the process id. `--local` reads it.
`.telnyx/telnyx.toml`, `.telnyx/index.ts`, `.telnyx/telnyx-env.d.ts`, `.telnyx/package.json`	`deploy`, and `dev` on a code project	The Edge Compute project the agent ships as: the manifest, the entry, the types, the dependencies. Rewritten on every `deploy`; never edited by hand.
`.telnyx/node_modules/`	`deploy`	Links to the CLI’s own copies of `@telnyx/acp` and `@telnyx/edge-runtime`, what the bundle is built from.
`deployed` in `agent.json`	`deploy`	The function id and name, the mount URL, the actor type, the active revision and a note per revision shipped, and what `deploy` set up for each number, the email inbox and each channel, so `delete` can undo it.

.telnyx/ is gitignored from the start; agent.json and instructions.md are the project, and are what to commit.