Skip to content

shujanshaikh/ama

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

190 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lovable, but for localhost

An AI agent that lives in your browser and makes changes to your local codebase.

Demo

Project Architecture

ama/
├── apps/
│   ├── web/         # Frontend application (React + TanStack Start)
│   └── server/      # Legacy backend API server (kept unchanged)
├── packages/
│   ├── bridge/      # Cloudflare Workers + Durable Objects backend
│   ├── cli/         # CLI runtime and daemon
│   ├── agent/       # Tool implementations used by the CLI
│   └── db/          # Database schema and queries

Tech Stack

  • TypeScript - For type safety and improved developer experience
  • TanStack Start - SSR framework with TanStack Router
  • TailwindCSS - Utility-first CSS for rapid UI development
  • shadcn/ui - Reusable UI components
  • Turborepo - Optimized monorepo build system

Getting Started

Prerequisites

  • Bun installed

Installation

bun install

Environment Variables

Create .env files with the following variables:

apps/web/.env

WORKOS_API_KEY=''
WORKOS_CLIENT_ID=''
WORKOS_COOKIE_PASSWORD=""
DATABASE_URL=""
WORKOS_REDIRECT_URI=http://localhost:3001/api/auth/callback
UPLOADTHING_TOKEN=''
VITE_API_URL=http://localhost:8787/api/v1
VITE_WS_URL="ws://localhost:8787"

packages/bridge/.dev.vars

WORKOS_CLIENT_ID=""
WORKOS_API_KEY=""
DATABASE_URL=""
UPSTASH_REDIS_REST_URL=""
UPSTASH_REDIS_REST_TOKEN=""
EXA_API_KEY=""
SUPERMEMORY_API_KEY=""
OPENCODE_API_KEY=""
REDIS_URL=""

Running the Development Server

bun run dev

Open http://localhost:3001 in your browser to see the web application.

Building the CLI Agent

cd packages/cli
bun run build
bun link

This will build and link the CLI globally so you can use it from any directory.

Available Scripts

  • bun run dev - Start all applications in development mode
  • bun run build - Build all applications
  • bun run dev:web - Start only the web application
  • bun run dev:server - Start only the Cloudflare Worker bridge backend
  • bun run check-types - Check TypeScript types across all apps

About

Lovable but for localhost

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages