@iechor/research-cli-core
v0.4.4
Published
Research CLI Core
Readme
Research CLI

This repository contains the Research CLI, a command-line AI workflow tool that connects to your tools, understands your code, and accelerates your workflows. Now with comprehensive academic research capabilities!
🎓 Academic Research Features
The Research CLI has been enhanced with powerful academic research tools:
📝 Paper Writing & Management
- Paper Outline Generator: Create structured outlines for research papers, reviews, and case studies
- Academic Writing Assistant: Grammar checking, style improvements, and citation verification
- LaTeX Manager: Full LaTeX project management with compilation and template support
- Bibliography Manager: Search arXiv, PubMed, IEEE, and other databases with BibTeX export
🔬 Research & Analysis
- Experiment Code Generator: Generate research code for Python, R, MATLAB, and Julia
- Data Analyzer: Statistical analysis, machine learning, and data visualization
- Citation Network Analysis: Explore research connections and paper relationships
🚀 Submission & Publishing
- Journal Matcher: Find suitable journals based on your research content
- Submission Preparator: Package papers for journal submission with templates
- Template Extractor: Extract LaTeX templates from arXiv papers
💡 Research Workflow Commands
/research search "machine learning"- Search academic literature/research analyze paper.pdf- Analyze document structure and style/research experiment python ml- Generate experiment code/paper outline "AI Safety"- Create paper structure/submit prepare --journal "Nature"- Prepare submission package
🚀 General Capabilities
With the Research CLI you can also:
- Query and edit large codebases in and beyond Research's 1M token context window.
- Generate new apps from PDFs or sketches, using Research's multimodal capabilities.
- Automate operational tasks, like querying pull requests or handling complex rebases.
- Use tools and MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria
- Ground your queries with the iEchor Search tool, built in to Research.
Quickstart
Prerequisites: Ensure you have Node.js version 20 or higher installed.
Run the CLI: Execute the following command in your terminal:
npx https://github.com/iechor-research/research-cliOr install it with:
npm install -g @iechor/research-cli researchPick a color theme
Authenticate: When prompted, sign in with your personal iEchor account. This will grant you up to 60 model requests per minute and 1,000 model requests per day using Research.
You are now ready to use the Research CLI for both development and academic research!
🎓 Research Workflow Example
# Start the CLI
research
# Search for papers on your topic
/research search "neural networks" --source=arxiv --limit=10
# Generate a paper outline
/paper outline "Deep Learning for Computer Vision" --type=research
# Create experiment code
/research experiment python deep-learning --output=./experiments
# Analyze your draft
/research analyze draft.tex --type=all
# Find suitable journals
/submit journal --topic "computer vision" --impact-factor=high
# Prepare submission
/submit prepare --project ./my-paper --journal "Nature Machine Intelligence"Use a Research API key:
The Research API provides a free tier with 100 requests per day using Research 2.5 Pro, control over which model you use, and access to higher rate limits (with a paid plan):
Generate a key from iEchor AI Studio.
Set it as an environment variable in your terminal. Replace
YOUR_API_KEYwith your generated key.export GEMINI_API_KEY ="YOUR_API_KEY"(Optionally) Upgrade your Research API project to a paid plan on the API key page (will automatically unlock Tier 1 rate limits)
Use a Vertex AI API key:
The Vertex AI API provides a free tier using express mode for Research 2.5 Pro, control over which model you use, and access to higher rate limits with a billing account:
Generate a key from iEchor Cloud.
Set it as an environment variable in your terminal. Replace
YOUR_API_KEYwith your generated key and set GOOGLE_GENAI_USE_VERTEXAI to trueexport GOOGLE_API_KEY="YOUR_API_KEY" export GOOGLE_GENAI_USE_VERTEXAI=true(Optionally) Add a billing account on your project to get access to higher usage limits
For other authentication methods, including iEchor Workspace accounts, see the authentication guide.
Examples
Once the CLI is running, you can start interacting with Research from your shell.
You can start a project from a new directory:
cd new-project/
research
> Write me a Research Discord bot that answers questions using a FAQ.md file I will provideOr work with an existing project:
git clone https://github.com/iechor-research/research-cli
cd research-cli
research
> Give me a summary of all of the changes that went in yesterdayNext steps
- Learn how to contribute to or build from the source.
- Explore the available CLI Commands.
- If you encounter any issues, review the Troubleshooting guide.
- For more comprehensive documentation, see the full documentation.
- Take a look at some popular tasks for more inspiration.
Troubleshooting
Head over to the troubleshooting guide if you're having issues.
Popular tasks
Explore a new codebase
Start by cding into an existing or newly-cloned repository and running research.
> Describe the main pieces of this system's architecture.> What security mechanisms are in place?Work with your existing code
> Implement a first draft for GitHub issue #123.> Help me migrate this codebase to the latest version of Java. Start with a plan.Automate your workflows
Use MCP servers to integrate your local system tools with your enterprise collaboration suite.
> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.Interact with your system
> Convert all the images in this directory to png, and rename them to use dates from the exif data.> Organize my PDF invoices by month of expenditure.Uninstall
Head over to the Uninstall guide for uninstallation instructions.
Terms of Service and Privacy Notice
For details on the terms of service and privacy notice applicable to your use of Research CLI, see the Terms of Service and Privacy Notice.
