Your first agent

This assumes a daemon is installed and at least one provider shows available in frogg status.

App

1. Add a project. On the home screen choose Add a project and pick a folder on the daemon host. A git repository gets branch, diff and worktree features.

   

2. Open its workspace. The project appears in the sidebar with a workspace for the current checkout (here main).

3. Write a prompt in the composer. Pick the model and the permission mode below it. Always ask prompts before edits and commands.

4. Approve or deny. The agent pauses on actions its mode does not allow and shows the exact change.

   

5. Review. The timeline shows every tool call and message. Use the diff panel and the Commit action in the header when you are happy.

   

CLI

cd ~/code/acme-api
frogg project create .
frogg agent run --provider claude --mode default \
  "Add a GET /version endpoint that returns the package version, and document it in README.md"

Pending approvals from another terminal:

frogg permissions ls
frogg permissions allow <agent-id> --all

Follow and continue the conversation:

frogg agent logs <agent-id> --follow
frogg agent send <agent-id> "Also add a test for /version"

What just happened

• The agent runs on the daemon, using the provider CLI installed there, in the project directory. Closing the app does not stop it.
• Every client connected to that daemon sees the same agent, timeline and pending permissions, live.
• Work in a separate branch without touching your checkout by creating a worktree workspace. See projects and workspaces.

Next

• Agents and the timeline
• Permissions
• Providers