Lokuma Design Agent: Overview & Getting Started

Lokuma Agent is a design intelligence layer for AI agents and developer workflows. It helps turn raw AI outputs into structured, visually refined designs—improving layout, typography, and overall clarity.

In this guide, you'll learn how to install Lokuma Agent, set up your API key, and start using it in your workflow.

1. Quick Start

Get Lokuma running in under a minute:

Install Lokuma Agent

Set your API key

Run your first prompt

Try running your first prompt in your agent:

• Make me a website for people who love skiing in the Alps, using lokuma skill
• Build a simple landing page for a coffee shop

Lokuma will help structure the layout, typography, and visual hierarchy of the generated result.

2. What Lokuma Agent does

Lokuma Agent connects your agents and local environment to Lokuma’s design intelligence—enabling your AI workflows to produce structured, high-quality designs.

With Lokuma Agent, you can:

• connect your agent to Lokuma’s design intelligence
• generate structured layouts and pages from AI output
• improve typography, hierarchy, and visual consistency automatically

Installation Details

Run the command below in your terminal:

This command:

• installs the Lokuma CLI
• connects your environment to Lokuma Agent
• enables agent tools in your development workflow

After installation, restart your AI tools (such as Claude Code, Codex, or similar environments) to ensure Lokuma Agent is properly loaded. This helps your agent recognize and use Lokuma’s design capabilities correctly.

After installation

Once installation is complete, the next step is to authenticate and connect your account. You will need:

1. a Lokuma account
2. an API key
3. available credits or billing enabled

If you have not created an API key yet, go to API Keys in the console.

3. Set up API Keys

API keys let your local environment and tools securely access Lokuma Agent.

Create an API key

1. Open the Lokuma console
2. Go to API Keys
3. Click Create API Key
4. Copy and store the key in a secure place

For security reasons, treat your API key like a password.

Best practices

• do not hardcode keys into public repositories
• use environment variables when possible
• rotate keys if you believe one has been exposed
• delete keys you no longer use

Recommended setup

Store your API key as an environment variable in your terminal configuration or project environment.

Example:

Then reload your shell or restart your terminal session.

4. Billing & Usage

Lokuma Agent uses a credit-based billing model. Your billing page helps you:

• view your current credit balance
• monitor usage
• purchase more credits
• apply promo codes when available

How billing works

Lokuma Agent usage is metered based on API and agent activity. As you use the product, credits are consumed according to your usage.

Typical usage may include:

• agent calls
• design generation or refinement tasks
• API requests made through connected tools or environments

Buying credits

Credits can be purchased in the Billing & Usage page:

• $10
• $20
• $50
• $100
• custom amount

Promo codes

If you received a promo code during a launch or campaign:

1. go to Billing & Usage
2. enter the code in the promo code field
3. apply the code before checkout (if supported)

Usage visibility

On the billing page, users should be able to see:

• total credits remaining
• recent usage
• purchase history or top-ups
• current billing status

5. Agent Setup

Lokuma Agent works inside AI-native development environments. Once installed and your API key is set, it activates automatically when your agent generates visual output.

Supported environments:

• Claude Code — restart after install; Lokuma appears as an available skill
• Cursor — restart after install; use Lokuma in agent and Composer modes
• Other environments that support CLI-based tool extensions

For a full walkthrough with examples, see the Lokuma Design Agent tutorial.

6. Troubleshooting

Install command does not run

Check the following:

• your terminal has permission to run shell scripts
• your network connection is stable
• your environment supports the required dependencies

Try running the install command again:

CLI installed but agent does not connect

Possible reasons:

• API key is missing or invalid
• billing is not enabled or credits are unavailable
• environment variables were not loaded correctly
• local environment configuration is incomplete

API key issues

If authentication fails:

• confirm the key is copied correctly
• check whether the key has been revoked
• generate a new key if needed

Billing or usage looks incorrect

Go to Billing & Usage to check:

• your remaining credits
• recent usage records
• any recent purchases or promo code applications

If something still looks off, contact support.

7. FAQ

1. Do I need an API key to use Lokuma Agent?

   • Yes. In most agent and API-based workflows, an API key is required to authenticate your environment.

2. Do I need credits before I start?

   • Yes. Lokuma Agent uses a usage-based credit model, so an active credit balance is required. You can purchase credits from the Billing & Usage page in your Lokuma console — packages start at $10.

3. Can I use Lokuma Agent with my existing AI tools?

   • Yes. Lokuma Agent is designed to work alongside AI-native development workflows.

4. Is Lokuma Agent the same as Website Builder?

   • No. Lokuma Agent is the developer- and agent-facing product experience for bringing Lokuma’s design intelligence into external workflows.
   • Lokuma Website Builder is a separate product area inside Lokuma.

8. Support

If you run into issues with installation, billing, or API access, contact the Lokuma team through the support channel listed in the console or on the website.

Email: support@lokuma.ai

Recommended support topics:

• installation issues
• billing questions
• API key problems
• credits and usage clarification
• integration troubleshooting

---

Next steps

• Design Agent Tutorial — full walkthrough with real examples in Claude Code and Cursor
• Lokuma Website Builder — building a website instead of an AI workflow? Start here
• Billing & Usage — manage your credits and account

---

Frequently Asked Questions

What is the difference between Lokuma Design Agent and Lokuma Website Builder?

Lokuma Design Agent is a CLI skill for developers using AI environments like Claude Code and Cursor — it adds design intelligence to AI-generated layouts. Lokuma Website Builder is a separate browser-based product for non-developers building complete websites.

Which AI environments support Lokuma Design Agent?

Claude Code and Cursor are officially supported, plus other environments that allow CLI-based tool extensions. Restart your AI tool after installation so it can recognize Lokuma as an available skill.

How are credits consumed by Lokuma Design Agent?

Credits are metered based on agent calls, design generation, and refinement requests. You can monitor balance and recent usage on the Billing & Usage page in your Lokuma console.

Where do I store my API key safely?

Store it as an environment variable (for example LOKUMA_API_KEY) instead of hardcoding it in source. Never commit keys to public repositories, and rotate any key you suspect has been exposed.