Go to app.guild.ai and sign in with your Google or GitHub account.
2
Create a workspace
Click the /home Workspace in the sidebar. This is a default Workspace in your personal Guild account.
3
Install an agent
Inside your /home workspace, go to Agents and click Add agent. Browse the Agent Hub and install one (try github-issues if you have a GitHub integration, or any public agent).
4
Start a session
Go back to your workspace and click New session. Select your agent, type a message, and press Enter.The agent runs and responds in the session panel. It may ask clarifying questions or request access to services along the way.
To connect GitHub, Slack, Jira, or other services, go to your organization’s Settings > Credentials and click Connect for each service.
Paste this into your coding agent (Claude Code, Cursor, Codex, etc.) to get started:
Coding agent prompt
Install the Guild CLI globally with npm: npm install -g @guildai/cliAuthenticate by running: guild auth login --no-browserThis will print a URL. Tell me to open it in my browser to complete authentication, then wait for the command to finish.After auth succeeds, run: guild setupThis will install skills for guild agent development.Then select the home workspace: guild workspace select homeThen create a new agent: mkdir hello-agent && cd hello-agent && guild agent init --name hello-agent --template LLMEdit agent.ts to be a friendly greeting agent using llmAgent with multi-turn mode and guildTools.Test the agent with: echo '{"prompt":"Hello!"}' | guild agent test --mode jsonAsk me if the response looks good. Once I confirm, save and publish with: guild agent save --message "First version" --wait --publish
Or follow the steps below manually.Ready to build a custom agent? The Guild CLI handles the full workflow: create, test, save, publish.
This creates the agent in the Guild backend, initializes a local git repo, and pulls starter files:
hello-agent/├── agent.ts # Your agent code├── package.json # Dependencies (runtime packages are pre-configured)├── tsconfig.json # TypeScript config├── guild.json # Local config (managed by the CLI)└── .gitignore
2
Edit the agent
Open agent.ts and replace the contents:
import { llmAgent, guildTools } from "@guildai/agents-sdk"export default llmAgent({ description: "A friendly greeting agent", tools: { ...guildTools }, systemPrompt: `You are a friendly assistant. Greet users warmly and answer their questions.`, mode: "multi-turn",})
mode: "multi-turn" keeps the conversation going after each response. llmAgent automatically includes ui_notify, but not the full userInterfaceTools set. Add userInterfaceTools explicitly if your agent needs ui_prompt or ui_ping.
3
Select a workspace
guild workspace select
This prompts you to pick a workspace interactively. You can also pass --workspace <id> to guild agent test directly.
4
Test it
guild agent test
This opens an interactive chat session. Ephemeral versions are created automatically when testing from a local agent directory:
You: Hello!Agent: Hello! Welcome. I'm happy to help. What can I do for you today?
Press Ctrl+C to exit.
5
Save and publish
guild agent save --message "First version" --wait --publish
--wait blocks until validation passes
--publish makes the agent available to your organization
Your agent is live. Install it in a workspace to use it.For details on publishing workflows, see Publish to the Agent Hub.
