Lokuma Design Agent: Overview & Getting Started

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

This guide walks through installing Lokuma Agent, setting up your API key, and using it in your workflow.

1. Quick Start

Get Lokuma running in under a minute:

Install Lokuma Agent

Set your API key

After installation, create an API key in the Lokuma Console (see Section 3 below) and export it in your shell:

Then reload your shell or restart your AI tool.

Run your first prompt

Try one of these in your AI agent:

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

Lokuma will 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 AI 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 install command in your terminal:

The script:

• Installs the Lokuma CLI
• Connects your environment to Lokuma Agent
• Enables agent tools in your development workflow

After installation, restart your AI tools (Claude Code, Cursor, Codex, or similar) so Lokuma Agent is properly loaded and recognized.

After installation

Once the CLI is installed, the next step is to authenticate. You'll need:

1. A Lokuma account
2. An API key (created from the Console — see below)
3. Available credits or billing enabled

3. Set up API Keys

API keys let your local environment securely access Lokuma Agent.

Create an API key

1. Open the Lokuma Console — sign in if prompted.
2. In the left sidebar, under DESIGN AGENT, click API Keys.
3. Click Create API Key, give it a name (e.g. "Claude Code laptop"), and copy the generated key immediately — it's shown only once.
4. Store it in a password manager or your environment configuration.

For security, treat your API key like a password.

Best practices

• Never hardcode keys in source files or public repositories.
• Use environment variables (LOKUMA_API_KEY) so the key isn't in your code.
• Rotate keys if you believe one has been exposed.
• Delete unused keys from the Console — fewer active keys means smaller blast radius.

Recommended setup

Store your API key as an environment variable in your terminal configuration:

Reload your shell (source ~/.zshrc) or restart the terminal session, then verify:

4. Billing & Usage

Lokuma Agent uses a credit-based billing model. The Billing & Usage page (Console sidebar → DESIGN AGENT → Billing) lets you:

• View current credit balance
• Monitor usage
• Purchase additional credits
• Apply promo codes

How billing works

Lokuma Agent usage is metered based on API and agent activity. As you build or refine designs through the agent, credits are consumed.

Typical credit consumption:

• Agent calls
• Design generation or refinement tasks
• API requests made through connected tools

Buying credits

Credit top-ups are purchased on the Billing page in these denominations:

• $10
• $20
• $50
• $100
• Custom amount

Promo codes

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

1. Go to Console → DESIGN AGENT → Billing.
2. Enter the code in the promo-code field.
3. Apply the code before checkout (if supported).

Usage visibility

The Console's Usage page (under DESIGN AGENT) shows:

• Total credits remaining
• Recent usage records
• Purchase history and top-ups
• Current billing status

5. Supported environments

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.

Officially supported:

• 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 or skills.

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

6. Troubleshooting

Install command doesn't run

Check:

• Your terminal has permission to run shell scripts (curl | bash works in your environment).
• Your network connection is stable.
• Your environment supports the required dependencies (Bash 4+, curl).

Retry:

CLI installed but agent doesn't connect

Likely causes:

• API key is missing or invalid (echo $LOKUMA_API_KEY returns empty).
• Billing is not enabled or credits are unavailable.
• Environment variables weren't loaded into the AI tool's environment.
• AI tool wasn't restarted after install.

API key issues

If authentication fails:

• Confirm the key was copied correctly (no trailing whitespace).
• Check whether the key has been revoked from Console → API Keys.
• Generate a new key if needed.

Billing or usage looks incorrect

Go to Console → Billing to check:

• Remaining credits
• Recent usage records
• Any recent purchases or promo-code applications

If something still looks off, contact support@lokuma.ai.

Next steps

• Design Agent Tutorial — full walkthrough with real examples in Claude Code and Cursor.
• Lokuma Website Builder — building a website in-browser instead of via AI workflow? Start here.
• Pricing Plans — manage credits, subscriptions, and billing for both Website Builder and Design Agent.

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. Both share the same design intelligence engine and Lokuma account, but credits and billing are managed separately (see Console sidebar: DESIGN AGENT vs. WEBSITE BUILDER sections).

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. Monitor your balance and recent usage on Console → DESIGN AGENT → Billing.

Where do I store my API key safely?

Store it as an environment variable (e.g. LOKUMA_API_KEY) in your shell config (~/.zshrc or ~/.bashrc), not in code. Never commit keys to public repositories, and rotate any key you suspect has been exposed. Delete unused keys from the Console.

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.

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.

Can I use Lokuma Agent and Website Builder from the same account?

Yes. Sign in once and the Console shows both products in the left sidebar: DESIGN AGENT (with its own Billing / Usage / API Keys) and WEBSITE BUILDER (with Subscription / Usage / Rewards). They share the same login but each has independent credit allowances and billing.