Alma Client

Alma is a powerful and beautifully designed AI client that integrates code writing, terminal operations, Git management, browser access, and more — providing developers with a complete AI-assisted programming experience.

🔗 Links

Alma Website	https://alma.now/

✨ Features

Alma offers the following capabilities:

• ✅ Code Writing: Intelligent code generation and completion
• ✅ Terminal Operations: Integrated terminal for direct command execution
• ✅ Git Management: Visual Git operations
• ✅ Browser Integration: Built-in browser support
• ✅ Multi-Model Support: Supports Claude, Gemini, and more
• ✅ Custom Providers: Connect to custom API providers

🛠️ Installation & Configuration

Step 1: Install Alma

Visit the Alma website to download and install the version for your operating system.

Step 2: Set the Interface Language

For a better experience, you can set the interface to your preferred language:

1. Open the Alma app
2. Go to Settings → General → Language
3. Select your preferred language

Step 3: Add 3xCoder as a Custom Provider

1. Open Provider Settings

   Click Select Provider → Add Custom Provider

2. Configure the 3xCoder Provider

   Fill in the following details:

   Field	Value
   Provider Name	3xCoder (or any name you prefer)
   Base URL	https://api.3xcoder.com/v1
   API Key	An API Key created from the 3xCoder Console

   TIP

   When using Claude models, make sure to use the API Key associated with the corresponding token group.

3. Fetch Available Models

   After adding the provider, click the Fetch button on the 3xCoder provider page. All available models will be retrieved automatically. Select the model you need to get started.

Step 4: Configure Multiple Token Groups (Optional)

3xCoder supports accessing different model collections via different API Keys.

On the provider page, you can:

1. Enter API Keys for different token groups
2. Fetch the model list for each group
3. Switch between groups as needed

💬 Starting a Chat

Important Setting

When creating a new chat, the Context Scope setting is critical:

Strongly Recommended

Choose "Select All" instead of "Auto"!

Testing shows that the "Auto" option can cause severe hallucination issues, such as:

• Referencing files that don't exist
• Generating incorrect code logic
• Misunderstanding the project structure

Choosing "Select All" ensures the model receives complete context and provides more accurate responses.

Tips for Use

1. Code Writing

   • Describe your requirements and Alma will generate the corresponding code
   • Supports multi-file operations and project-level changes
   • Preview and modify generated code in real time

2. Terminal Operations

   • Execute commands directly in the integrated terminal
   • View command output inline
   • Interactively debug issues with AI assistance

3. Git Management

   • Visualize Git status at a glance
   • AI-assisted commit message writing
   • Branch management and merge support

4. File Browsing

   • Browse project file structures
   • Quickly locate and edit files
   • File search and filtering support

🎯 Best Practices

1. Choose the Right Model

• Claude Sonnet: Great for everyday coding tasks — fast and responsive
• Claude Opus: Best for complex architecture design and challenging problems
• Gemini: Ideal for tasks requiring multimodal capabilities (e.g., image understanding)

2. Use Context Wisely

• For small projects, select all files with "Select All"
• For large projects, select only the relevant modules and files
• Regularly clear unrelated context to avoid wasting tokens

3. Make Full Use of Alma's Integrations

• Use the terminal to verify AI-generated code
• Manage code versions with Git integration
• Use the browser to view documentation and references

Frequently Asked Questions

How do I switch between different API providers?

Use the model selector at the top of the chat interface to switch providers and models at any time.

Why can't I use some models?

• Check whether the API Key has permission to access that model
• Confirm your account balance is sufficient
• Review the token group settings in the 3xCoder Console

What's the difference between Alma and Claude Code?

	Alma	Claude Code
Interface	Graphical UI	Command-line interface
Use Case	Full-featured development environment	Quick terminal operations
Integrations	Terminal, Git, Browser, etc.	Pure command-line tool
Learning Curve	Low	Higher

Choose based on your specific workflow and preferences.

✅ Done

🎉 Setup complete! You're now ready to use Alma for AI-assisted programming!

Key reminders:

• ✅ Set context scope to "Select All"
• ✅ Choose the right model for each task
• ✅ Make full use of Alma's integrated features
• ✅ Check your API balance regularly