feat: add AI agent to backend-and-client template #153

Paveltarno · 2026-01-29T06:45:00Z

Description

This PR adds a pre-configured AI task management agent template to the backend-and-client project template. The agent provides a conversational interface for managing tasks through natural language interactions with the Task entity, demonstrating how AI agents can be integrated into Base44 projects. The agent template file is included in new projects created with this template.

Related Issue

None

Type of Change

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
Documentation update
Refactoring (no functional changes)
Other (please describe):

Changes Made

Added task_manager.jsonc agent configuration file to templates/backend-and-client/base44/agents/ directory
Agent includes full CRUD permissions (read, create, update, delete) for Task entities
Configured with conversational instructions for natural task management interactions
Template file is automatically included when users create new projects with the backend-and-client template

Testing

I have tested these changes locally
I have added/updated tests as needed
All tests pass (npm test)

Checklist

My code follows the project's style guidelines
I have performed a self-review of my own code
I have commented my code, particularly in hard-to-understand areas
I have made corresponding changes to the documentation (if applicable)
My changes generate no new warnings
I have updated AGENTS.md if I made architectural changes

Additional Notes

The task_manager agent serves as both a practical feature for projects created with the backend-and-client template and as a reference implementation for developers learning how to integrate AI agents. Users can interact with it conversationally to create, update, complete, and delete tasks.

Note: Earlier commits in this PR included agent deployment integration code in the create command flow, but that was removed in subsequent refactoring commits (b876e0a) to keep the implementation focused on providing the template file only.

_{🤖 Generated by Claude | 2026-01-29 19:45 UTC}

github-actions · 2026-01-29T06:45:29Z

🚀 Package Preview Available!

Install this PR's preview build with npm:

npm i @base44-preview/[email protected]

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/[email protected]"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/[email protected]"
  }
}

📦 Preview Package: @base44-preview/[email protected]
🔗 View this commit on GitHub

_{Preview published to npm registry — try new features instantly!}

claude · 2026-01-29T06:48:31Z

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

Add task_manager agent configuration to the backend-and-client template and prompt users to configure AI agents during project creation. Co-Authored-By: Claude Opus 4.5 <[email protected]>

Paveltarno · 2026-01-29T07:10:24Z

src/cli/commands/project/create.ts

+          successMessage: theme.colors.base44Orange("AI agent configured successfully"),
+          errorMessage: "Failed to configure AI agent",


@claude let's add the same plural/singular logic you have in 203
you can probably reuse a little helper here

Claude finished @Paveltarno's task in 56s —— View job

Done!

Tasks

Read the file to understand the plural/singular logic at line 203

Create a reusable helper function for plural/singular formatting

Apply the helper at line 203

Apply the helper at line 209 (success and error messages)

Commit and push changes

Summary

I've added a reusable pluralize helper function and applied it to the agent configuration messages:

Changes made:

Created pluralize(count, singular, plural?) helper function that handles singular/plural forms

Applied it to the loading message: `Configuring ${agents.length} AI ${pluralize(agents.length, "agent")}...`

Applied it to the success message: `AI ${pluralize(agents.length, "agent")} configured successfully`

Applied it to the error message: `Failed to configure AI ${pluralize(agents.length, "agent")}`

The helper now makes it easy to reuse this logic anywhere else in the codebase where plural/singular handling is needed.

View commit |

Created a reusable pluralize helper function and applied it to agent configuration messages (loading message, success message, and error message) to properly handle both singular and plural cases. Co-authored-by: paveltarno <[email protected]>

Paveltarno · 2026-01-29T07:20:12Z

@claude, the helper you've added for pluralization is good but i think we can just use plural all the time the same as we do with data-models

claude · 2026-01-29T07:20:28Z

Claude finished @Paveltarno's task in 59s —— View job

Tasks

Read current implementation in create.ts
Remove pluralize helper function
Update all messages to always use "agents" (plural)
Commit and push changes

Summary

Removed the pluralize helper function and updated all agent-related messages to consistently use "agents" (plural), matching the pattern used for data-models elsewhere in the codebase.

Changes made:

Removed the pluralize(count, singular, plural?) helper function (lines 21-23)
Updated loading message: `Configuring ${agents.length} AI agents...`
Updated success message: `AI agents configured successfully`
Updated error message: `Failed to configure AI agents`

The messages now always use "agents" regardless of count, consistent with how "data models" are handled.

View commit |

Co-authored-by: paveltarno <[email protected]>

kfirstri · 2026-01-29T08:16:41Z

We have another task to remove questions from the create flow and minimize it to just 1, so lets keep in this PR only the template update, and we'll merge after we edit the questions.

Paveltarno · 2026-01-29T09:15:03Z

We have another task to remove questions from the create flow and minimize it to just 1, so lets keep in this PR only the template update, and we'll merge after we edit the questions.

@claude please remove the push code, leave only the agent config we've added to the template

claude · 2026-01-29T09:15:18Z

Claude finished @Paveltarno's task in 1m 16s —— View job

Tasks

Read current implementation in create.ts
Remove agent push/configuration code
Verify template file remains intact
Commit and push changes

Summary

Successfully removed the agent push/configuration code from src/cli/commands/project/create.ts while keeping the task_manager.jsonc template file intact.

Changes made:

Removed pushAgents import from the imports list
Removed agents from the destructured readProjectConfig result
Removed the entire agent configuration block (lines 189-213) that included:
- Interactive prompt asking "Configure AI agent?"
- Non-interactive auto-configuration logic
- Agent push task with loading/success/error messages

What remains:

✅ templates/backend-and-client/base44/agents/task_manager.jsonc - The agent template file is preserved

The PR now contains only the template addition, ready to be merged once the create flow questions are updated separately.

View commit |

Keep only the agent template file, remove the integration code that prompts and pushes agents during project creation. Co-authored-by: paveltarno <[email protected]>

claude · 2026-01-29T09:20:01Z

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

Paveltarno · 2026-01-29T09:37:48Z

We have another task to remove questions from the create flow and minimize it to just 1, so lets keep in this PR only the template update, and we'll merge after we edit the questions.

@kfirstri done, please take a look

Paveltarno force-pushed the pavelta-agents-template branch from 4c7830a to 9947faa Compare January 29, 2026 06:51

feat: add AI agent to backend-and-client template

685c294

Add task_manager agent configuration to the backend-and-client template and prompt users to configure AI agents during project creation. Co-Authored-By: Claude Opus 4.5 <[email protected]>

Paveltarno force-pushed the pavelta-agents-template branch from 9947faa to 685c294 Compare January 29, 2026 06:53

Paveltarno requested a review from kfirstri January 29, 2026 06:58

Paveltarno commented Jan 29, 2026

View reviewed changes

refactor: simplify agent messages to always use plural

a6f6792

Co-authored-by: paveltarno <[email protected]>

refactor: remove agent push code from create flow

b876e0a

Keep only the agent template file, remove the integration code that prompts and pushes agents during project creation. Co-authored-by: paveltarno <[email protected]>

Paveltarno enabled auto-merge (squash) January 29, 2026 09:37

kfirstri added this to CLI Development Jan 29, 2026

github-project-automation bot moved this to Backlog in CLI Development Jan 29, 2026

kfirstri moved this from Backlog to In review in CLI Development Jan 29, 2026

kfirstri approved these changes Jan 29, 2026

View reviewed changes

Paveltarno merged commit 4690f69 into main Jan 29, 2026
7 checks passed

Paveltarno deleted the pavelta-agents-template branch January 29, 2026 10:53

github-project-automation bot moved this from In review to Done in CLI Development Jan 29, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add AI agent to backend-and-client template #153

feat: add AI agent to backend-and-client template #153

Uh oh!

Paveltarno commented Jan 29, 2026 •

edited by claude bot

Loading

Uh oh!

github-actions bot commented Jan 29, 2026 •

edited

Loading

Uh oh!

claude bot commented Jan 29, 2026

Uh oh!

Paveltarno Jan 29, 2026

Uh oh!

claude bot Jan 29, 2026 •

edited

Loading

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

claude bot commented Jan 29, 2026 •

edited

Loading

Uh oh!

kfirstri commented Jan 29, 2026

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

claude bot commented Jan 29, 2026 •

edited

Loading

Uh oh!

claude bot commented Jan 29, 2026

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		successMessage: theme.colors.base44Orange("AI agent configured successfully"),
		errorMessage: "Failed to configure AI agent",

feat: add AI agent to backend-and-client template #153

feat: add AI agent to backend-and-client template #153

Uh oh!

Conversation

Paveltarno commented Jan 29, 2026 • edited by claude bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related Issue

Type of Change

Changes Made

Testing

Checklist

Additional Notes

Uh oh!

github-actions bot commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Package Preview Available!

Uh oh!

claude bot commented Jan 29, 2026

Code review

Uh oh!

Paveltarno Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

claude bot Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Done!

Tasks

Summary

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

claude bot commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Tasks

Summary

Uh oh!

kfirstri commented Jan 29, 2026

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

claude bot commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Tasks

Summary

Uh oh!

claude bot commented Jan 29, 2026

Code review

Uh oh!

Paveltarno commented Jan 29, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Paveltarno commented Jan 29, 2026 •

edited by claude bot

Loading

github-actions bot commented Jan 29, 2026 •

edited

Loading

claude bot Jan 29, 2026 •

edited

Loading

claude bot commented Jan 29, 2026 •

edited

Loading

claude bot commented Jan 29, 2026 •

edited

Loading